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PREFACE 


This manual describes the new linkage editor called the 
Perkin-Elmer OS/32 Link, which provides the user with the ability 
to link one or more object modules producing an image load 
module. These load modules can be tasks, sharable segments, or 
operating systems. The user should be familiar with the 
Perkin-Elmer O5/32 and with the Perkin-Elmer OS/32 Multi-Terminal 
Monitor (MTM) if Link is used in an MTM environment. 


Chapter 1 provides an introduction and overview of the features 
of Link. Chapter 2 describes how to build, load, and start the 
linkage editor. Chapter 3 lists and describes the link-edit 
commands. Chapter 4 guides the new user and explains the 
fundamentals of producing image load modules. Appendix A is a 
command summary. Appendix Bis a message summary» Appendix C 
compares Link to TET. Appendix D lists and describes the TET 
commands. 


Revision 01 of this manual adds support for these new features: 
trap event, vertical forms control, and supervisor call (SVC) 
interceptions. It also clarifies the LIBRARY command and 
includes changes to the OPTIONS and SHARED commands. This manual 
can be used with the OS/32 RC6 and higher software release and 
with Revision 00-91 of OS/32 LINK. 


The user can refer to these publications: 


MANUAL TITLE PUBLICATION 
NUMBER 
O0S/32 Operator Reference Manual 48-030 


OS/32 Applicaticn Lavel Proyrammer 
Reference Manual 48-039 


OS/32 Multi-Terminal Monitor (MTM) Reference 
Manual 48-043 


22-2it Systems User Documentation Summary 50-003 


For further information on the contents of all Perkin-Elmer 
32-bit manuals, see the 32-Bit Systems User Documentation 
Summarlye 
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CHAPTER 1 
OS/32 LINK 


1-1 INTRODUCTION 


The Perkin-Flmer 0S/32 Link is a linkage editor that combines one 
or more object modules produced by Perkin-Elmer language 
processors and produces an image loaad module with all external 
references resolved. This image load module then can be loaded 
by the LOAD command. 


1.2 LINK FEATURES 


This linkage editor can build image load modules in sizes up to 
16Mb. Tasks can be unsegmented or segmented into pure and impure 
segments which allows the user to share the pure code when more 
than one copy of the task is Loaded. Task options such as 
floating-point requirements, workspace size, and priority can be 
specified. Link also can build an operating system image from 
the object module produced by the Perkin-Elmer OS/32 Library 
Loader. The resulting imaye load module can be loaded into main 
storaye using the Perkin-Elmer O0S/32 Bootstrap Loader (BOOT) or 
Loader Storage Unit (LSU). 


Link automatically selects modules referenced by a user's task 
from specified object libraries, and links them to the main task. 
The library search is performed so that the order of the nodules 
in the library has no etfect on the link process. 


The linkage editor can display maps with the addresses of program 
modules, entry points, common blocks, and overlays. A map can be 
a build summary, or can have symbols and addresses listed in 
alphabetical or address order. In addition, a cross reference 
listing of entry points and program modules referencing them can 
be included. 


Link commands such as OPTION or POSITION, imbedded in an object 
module, are executed whenever the module is linked to a main 
taske The linkage editor can disable execution of these commands 
if a particular Link command (NDCMD) is specified by the user. 


Sharable segments, such as resident libraries or task commons, 
are independently linked load modules that can be concurrently 
used by more than one task. This linkage editor can build 
sharable segments and link a task to the sharable segment. 
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Link also supports a tree-Structured overlay feature. If the 
user specifies that routines are to be located in an overlay at 
link time, the linkage editor provides for automatic loading when 


the routine is referenced 
overlay structure does 


execution time. Therefore, the 
have to be defined in the source 


module. A Link command can place common areas in the root node 
or a specific node of the overlay structure. 


1-3 LINK REQUIREMENTS 


These resources are required for Link execution: 


@ OS/32 5.2 or higher 


e 1 disc device 


e 64kb of main storage for Link 


1.4 STATEMENT SYNTAX CONVENTIONS 


These statement syntax conventions are used in all conmand and 


instruction formats: 
CONVENTION 


Capital letters, 
parentheses, and 
Punctuation marks 


Lowercase letters 


Underlining 


PAUSE 


Ellipsis 


paramy,eee ,PATrAMs 


Lettering with shading 


USAGE 


i) 


must be entered exactly as shown. 


represent parameters or information 
provided by the user. 


indicates only the underlined por- 
tion of the entry is reguired. 


represents an indefinite number of 
Parameters Or a range of parameters. 


represents a default option. 
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CONVENTION 


Braces 


i | 


Brackets 


[| 


Commas 


Braces inside brackets 


Hf 


Comma preceding braces 
inside brackets 


pote 


Comma inside brackets 


Comma outside brackets 
except last parameter 


LU 


Equal sign separating 


Keyword from parameters 


KEYWORD=param 


1-4.1 Link Command Syntax 


Multiple commands can 


separated by semicolons 


USAGE 


represent required parameters) from 
which one must be chosen. 


represent an optional parameter that 
can be chosen. 


separate parameters and substitute 
Missing positional parameters. 


represent optional parameters from 
which one can be chosen. 


must be entered if one of the 
Optional paramneters is chosen. 


must pe entered if the optional 
parameter is chosen. 


must be entered in place of missing 
positional parameters andi to 
separate optional parameters that 
are chosene Commas are omitted for 
trailing parameters and a tomma must 
be entered with the last specified 
parametere 


must be entered to associate 
parameter with keyword. 


entered an one line if they are 


when nultiple commands are entered 


on the same line, they are executed sequentially. If a syntax 
error is detected in a command, that conmand plus any subsequent 
commands on the same line are ignored. 
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If the specified parameters of a command in interactive mode 
exceed one line, enter a comma as the last character and a 
carriage return (CR) which causes this message to be displayed: 


CONTINUED 


“Continue entering the remaining parameters on the same line 
following the greater than (>) symbol. In batch mode, paraneters 
can be continued by entering a comma as the last character and 
continuing the parameters on the following line. 


Comments can be specified by entering an asterisk (*) before the 
comment string and a CR or semicolon at the end of the string. 
A comment can be the only data on a line or can follow a command 
on the same line. For example: 


STHLS Lo THE Lisa” ROUTINE 


ESTABLISH LASK;*A TASK [5 TO BE ESTABLISHED 


1-422 File Descriptors 
File descriptors, abbreviated as fd, are entered in a standard 


formate 


Formats 


ove) Estemeeed CED a asad 


Parameters: 


voln: is a 1- to 4-character alphanumeric string 
specifying the name of a disc volume. The 
first character must be alphabetic and the 
remaining alphanumeric. If the volume name is 
omitted, the default is the: 


- volume specified by the Link VOLUME 
command, 


~ volume specified by the operator or MATA 
YOLUMF command, or 


- volume specified as the operating system or 
user default volume. 
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dev: 


filename 


actno 


file class 


Functional Details: 


is a 1~ to 4U-character alnhanumeric string 
specifying a device name. The first character 
must be alphabetic and the remaining 
alphanumeric. 

is a 1- to $8~character alphanumeric string 


Specifying the name of a file. The first 
character must he alphabetic and the remaining 
alphanumeric. If a filename is specified when 
a device name is specified, the filename is 
ignored. 


is a 1- to 3-character alphanumeric’ string 
specifying the extension to a filename. If 
the period (.) and extension are omitted, a 
default extension appropriate to the 
particular command in which the fd appears is 
appended to the filename. If the perioi is 
specified and the extension is omitt2d, the 
default is blanks. 


is a decinal number from 9 through 255 
specifying the account number associated with 
the file. Account nunbers 1 through 240 are 
used by MIM; account numbers 241 through 255 
are reserved. Account number 0 is used for 
system files and is the default for all 
operating system users. Specification of the 
account number aS part of the fd can be 
entered when running Link from the system 
console, 


is a I-character alphabetic string svecifying 
the file class. The file classes are: 


- D for private file 


- G for group file 


5 for system file 


If the file class is omitted, the default is 
P when running Link from an MTM terminal and 
S when running Link from the system console. 


See the 0S/32 Programmer Reterence Manual for more information on 


file descriptors. 
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CHAPTER 2 
STARTING LINK 


2-1 BUILDING LINK 


If the Perkin-Elmer supplied ready-to-execute version is to be 
used, no build is necessary. dowever, if a new version of Link 
is to be built, this sequence of commands builds Link as a 
sharable segmented image load module by using the Perkin-Elmer 
supplied version of Link. 


INCLUDE LINK 
OPTION SEGMENTED, WORK=8000 


BUILD LINK 

END 
The reserved workspace must be a minimum of 8kb. The more 
workspace aliocated, the less paging to and from disc. The less 
workspace allocated, the more paging to and from disc.e The 


amount of workspace specified can be overridden at load time. 
2-2 LOADING LINK 
Link must be a Segmented image load module before being loaded 


into main storage. 


202-1 Loading Link from the System Console 


This command loads Linx from the system consols. 
Format: 

LOAD taskidl [fda]L,segsize increment] 
peeowetenes 


taskid is ai- to 8-character alphanumeric string 
specifying the name of the task after it is 
loaded into the foreground segment in main 
storaye.e 
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fd is the file descriptor of the device 
containing the linkage editor image load 
module to be loaded into main storage. Tf 
this parameter is omitted, the. default is 
taskideISK. 


segsize is a decimal number in kb specifying the 

increment additional area to be added to the module's 
impure segment. This value overrides’ the 
WORK= option if specified when the module was 
built. 


2e2e2 Loading Link from an MTM Terminal 


This command loads Link from an MTM terminal. 
Format: 

LOAD f4 [,segsize increment ] 
Parameters: 


fd is the file descriptor Sf the device 
containing the linkage editor image load 
module to be loaded into main storage. 


seqgjsize is a decimal number in kb specifying the 

increment additional area to be added to the module's 
impure segment. This value overrides the 
WORK= option if specified when the module was 
Para Le 


2-3 STARTING LINK 
After Link is loaded into main storage this command starts its 
execution and assigns tne command and log devices. 
Format: 
START [,COMMAND=fd,][,LOG=£4, ] 


Parameters: 


COMMAND= fd, specifies the inout device from which 
commands are to be entered. If this parameter 
is omitted, the default is the command input 
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to 
! 
no] 


device (CON:). If the command input device is 
interactive, all commands entered ani messages 
generated are sent to the command input 
device. If the command input device is batch, 
the LOG parameter must be specified. 


LOG= fd2 specifies the output device to which all 
commands entered and messages generated are 
recorded. If the command input device is 
batch, this parameter must be specified. If 
the log cutput device is a disc file, it must 

have been previously allocated. 


Functional Details: 
After the linkage editor is started, this message is iisplayed: 
LINK Rnn-nn 


The revision number (Rnn) indicates the revision level of Link, 
and the update number (-nn) indicates the update level of Link. 
If the command input device is interactive, the greater than (>) 
Symbol is then displayed aS a prompt indicating the linkage 
editor is ready to accept commands. 
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CHAPTER 3. 
LINK COMMANDS 


361 INTRODUCTION 

There are three types of Link commands: 

e Active 

e Passive 

e Environment 

Active commands are executed as soon as they are entered and 
cause an immediate action to the image load nodule being built. 
Passive commands are executed when the build process occurs. 
Environment commands affect the link session instead of the image 


load module being built. 


Table 3-1 lists all the Link commands, categorizes the type, and 
describes the function. 


TABLE 3-1 LINK COMMANDS 


| { EYP E | | 
{} COMMAND [SSeS SSeS sess | MEANING { 
| { ACT | PAS | ENV | | 
| ==sSeessssaa| HSae=| = SsS5 | SSS | Sees e ssa sssssssesesesassssssSsae | 
{ BFILE | | | * | Backspaces a magnetic tape or | 
| | | | { contiguous file | 
ceuaiaa ees [eeese [Parse baesee hapa saaisc es i eamesuelnain sna | 
| BUILD jf os | {| Starts building the image load | 
| : | | | | module | 
[eeasesacare fesse [aSsse Laeses Goa gen eaain CARE aa arena | 
|} DCMD | | | | Enables execution of Link | 
| \.. * | | } commands imbedded in object | 
| | | | |} modules | 
(pecreeaise wee Rege ISaeee pee (patie sac saa aa aes | 
} END as | | {| Terminates the linkage editor | 

eee rasa Ieseiwegeel acini acokeris oaarae an aise a denied tela Sa 
ESTABLISH {| * | | | Specifies the type of image | 

| 


load module to be built | 
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TABLE 3-1 LINK COMMANDS (Continued ) 


| TYPE | | 
{ COMMAND [eee mer ene eee eee | MEANING | 
| {; ACT | PAS | ENV | | 
| =======S=== a | 
| EXTERNAL | | | {| Specifies the hame of the | 
| | | * | } common block to be referenced | 
| | { | {| outside a sharable segment { 
paereeceses peaeee (secs [==5=5 iaesenasoa 7s Sac ara ae | 
| FFILE | { | * | Forward spaces a magnetic tape | 

| | | {| or contiguous file | 
ean teen aa emeel carga) Gama) genase nea mcrae iene ccremnaa, 
| INCLUDE | | { | Specifies the object modules | 
| | * | | |} to be included in the image | 
| | | | | load module | 
ganeeiaean ee [Sao Gomes ee see eee eas eg terns | 
| LIBRARY | | { | Specifies the object libraries | 
| | t, | |} to be searchei for unresolved | 
| | | | | external references | 
ee gous peeaee boPoas eae presen eae eer aaee | 
| LOCKE | | | {| Specifies entry points to be | 
| | | * | | referenced only within a | 
| | { | | sharable segment | 
[peesserees= ineres paaess ede cede tua ae as Lee | 
| LOG | | | { Enables logging all commands, | 
| | | | | messages, and maps to the log | 
| | | {| * | device | 
[eee SSS eee= [sese2 [SqSre (eee [Reses sane a eae Siberia aaEaerasee | 
| MAP | fo es | | Generates a map when the image | 
| { | | {| load module is built | 
[eg aes artist etosana sntherereseh es oO nr mere ence ese ntene ae 
| NDCMD | | | {| Disables execution of Link | 
| ; * | | { commands imbedded in | 
| | | | | object modules | 
[pereeseees [peers [aaece [Pas eee es eae ae eeeoeeee | 
| NLOG | | | | Disables logging all commands, | 
| | | | * | messages, and maps to the log | 
| | | | {| device | 
lucie mamaniis [asec [esos poeees lata ais ganda Aree eee es Saat 
| OPTION | |} * | { Sets task options | 
sick eta ci eae aol ba ide peta teria gern 
} OVERLAY {| * | | | Defines an overlay and | 
j | | | | specifies a level. | 
[Arerseezse2 aces [esce [aes fe eens eee ed msgs en ee | 
| PAUSE | | |} * | Pauses the linkage editor | 
pee eco Coats ewe ete! erie eee ea ge duck ac eIa 
|} POSITION | { * | {| Moves a common block into | 
{ | | | | a specific overlay node. | 
(pose eae secs [eres ease jadaae Teuduiag peace manne emma 4 onsen | 
{| REWIND | | {| * | Rewinds a magnetic tape orf 
| { | | | contiguous file { 
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TABLE 3-1 LINK COMMANDS (Continued ) 


_— om ab at ow 


2 OR em Cee OO oD ame UE ED ere uD UND ce me em cme ee cm ee ee eee ome ee ee ee ne ee oe ee 
Ss 


Specifies a segment can be] 
referenced by more than  one| 
task i 


Specifies a title for the map| 


Specifies the default volume] 
to be used for all subsequent| 
file descriptors | 


Writes a filemark on a magnetic] 
tape or a contiguous file| 


oes am ee ee ee om ow a om ae ae ae om ee oe oe om ow we a oe am ow at ws am om em & om ah ee es Om am ae om om oF ow ae a am om o8 om om oe om oe FF om me em am ae oe oe ww ow oe ow 


* Indicates the type of Link command 
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ee wwaew ewan a = 


3-2 BFILE COMMAND 


The backspace file (BFILE) command is an environment command that 
packspaces'a magnetic tape or contiguous file a specified number 


of filemarks. 
Formats: 

BFILE fa [, n| 
Parameters: 


fd 


Examples: 


BF MAG1:,2 


is the file descriptor of the device to be 
backxspaced the specified number of filemarks. 


is a decimal number specifying the number of 


filemarks to space backwards. If this 
parameter is omitted, 1is the default. 
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3.3 BUILD COMMAND 
The BUILD command is an active command that builds the imag2 load 
module from the object modules specified in the INCLUDE command. 
Formats 

BUILD fd 


Parameters: 


naga is the file descriptor that is to receive the 
image load module. LE the extension is 
omitted, the default extensions are: 


eTSK for tasks 
~SEG for sharable segments 


-000 for operating systems 
Functional Details: 


The linkage editor attempts to allocate and assign the file 
specified in the BUILD command. If the file does not exist, the 
linkage editor allocates the file. However, if an error occurs 
during this process or the file is not specified in the BUILD 
command, this message is displayed: 


ENTER FILE-DESCRIPTOR OF IMAGE> 


Enter the fd of the device to receive the image load noiule. If 
the linkage editor is in batch mode and an fd is required, the 
build process is terminated. A pre-allocated empty indexed or 
contiguous file with sufficient space can be specified as the fd. 
If the file does not contain sufficient space, this message is 
displayed: 


FILE EXISTS - DO YOU WANT IT OVERWRITTEN?> 
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If YES is entered, the file is deleted and re-allocated. If No 
is entered, this message is displayed: 


ENTER FILE-DESCRIPTOR OF IMAGE> 


Enter the fd to receive the image load module which cau the 


allocation/assignment process to be repeated. 


U) 
a0) 
9) 


NOTE 


Building an image load module on a 
contiguous file is significantly faster 
than building an image load module on an 
indexed file. 


After these messages are displayed, the maps are generated if the 
MAP command was entered. If the MAP command was not entered, 
this message is disrlayed: 


MAP?> 


If YES (Y) or NO (8) is entered, the following four messages are 
displayed: 


ENTER MAP FILE DESCRIPTOR> 


Enter the fd of the device or file to receive the naps. 


SORTED ALPHABETICALLY?> 


If YES is entered, a map with all symbols in alphabetical order 
is generated: 


SORTED BY ADDRESS ?> 


Tf YES is entered, a map with all symbols in address order is 
generated: 


CROSS REFERENCE? > 


If YES is entered, a map with all symbols in alvdhabetical order 
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and the names of all modules that reference each symbol is 
generated. 


If NO was entered for all of these messages, only a build summary 
is generated. See section 3.13. 


After the BUILD command is executed, the linkage editor is ready 
to build a new image load module. 


Examples: 


BU TASK 


PU TASK.TSK 


Messages: 


3 


UNDEFINED EXTERNAL SYMBOL(S) 


The specified number of undefined external symbols exist. 


n MULTIPLE DEFINED ENTRY POINTS(S) 


The specified number of entry points are defined more than 
once in the same pathe 


n AMBIGUOUSLY DEFINED ENTRY POINT(S) 


The specified number of entry points were defined in parallel 
paths and referenced from a node common to both paths. 


n COMMAND(S) ENCOUNTERED IN OBJECT CODE 


The specified number of Link commands were encountered in the 
object modules included in the image load module. 
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3.4 DCMD COMMAND 


The define command (DCMD) is an active command that enables 
execution of passive Link commands in object modules included in 
the image load module. 


Format: 


DCMD 


Functional Details: 


When an object module with imbedded passive Link commands is 
included, the imbedded commands are treated as if they were 
entered after the INCLUDE command was entered. Imbedded LIBRARY 
commands are treated aS if they were entered immediately before 
the BUILD command was entered. 


Link commands can te imbedded in an object module if the CAL DCMD 
pseudo-op was used during an assembly. Inly passive Link 
commands can be imbedded in object modules. Any active or 
environment commands imbedied in object modules are rejected and 
cause a message to be displayed. If a log device is specified, 
all Link commands in the object module are sent to the log device 
with a plus sign (+) in column 1. For example: 


ES TB 
INCLUDE MOD 
+OPTION FLOAT 

BUILD MOD 


If an error occurs during execution of an imbedded command, a 
message is displayed. The format of the CAL DCMD pseudo-op is: 


DCMD C'linkedit command‘ 


Examples: 


CDCMD CtOPTION FLOAT‘ 


DCMD C*MAP PR:,ALPUHA’ 
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3-5 END COMMAND 


The END command is an active command that terminates the: linkage 
editor. 
Format: 

END 


Functional Details: 


Tf the END command is entered after passive Link commands are 
entered but before the BUILD command is entered, this message is 
displayed: 


BUILD IMAGE FROM PREVIOUS [NPUT?> 


Enter YES if the image load module is to be built. Enter NO if 
no image load module is to be built and the task is to be 
terminated. See Table 3-2 for the list and meaning of the link 
end of task codes. 


TABLE 3-2 LINK .END OF TASK CODES 


iz] 
= 
oO 
(@) 
try 
ee | 
ba = 
op) 
A 


CODE | MEANING 
Se ee es a See: eek ee eee ae ee nee a Ons (ee eae oo Sees ae wee come. SSIs e Ss aeeSt esr a SSS Ses SS sss SsSsS=Ss= 
‘) Terminated normally 


1 An error occurred but did not affect 


the building of the image load module. 


An error occurred that affected the 


building of the image load module. 
3 A severe error occurred that caused 


NO 4 
a ilies aS an ia otal ea Satta ae 
ee oe a ic cae ll Oe SS 


the linkage editor to abort. 
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3-6 ESTABLISH COMMAND 

The ESTABLISH command is an active command that specifies the 
type of image load module to build. The three types of image 
load modules ares: 

o task, 


o sharable segment, and 


® operating system. 


Formats: 


m0000 
ESTABLISH SHAPED [, ACCESS= RE | [-appress= ] 


Parameters: 


TASK specifies that a task image load module is to 
he built. If the ESTABLISH command is 
omitted, TASK is the default. 


os specifies that an operating system image load 
module is to be built. 


SHARED specifies that a sharable segmented image load 
module is to be built. 


ACCESS= RF specifies that the access privilege of the 
sharable segment allows access of data within 
the sharable segment. Execution or 


modification of data is not allowed. 
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NAME= 


Functional Details: 


EF specifies that the access privilege of the 
sharable segment allows task execution within 
the sharable segment. 


RE specifies that the access privilege of the 
sharable segment allows access t9 data and 
task execution within the sSharable segment. 
Modification of data is not allowed. If the 
ACCESS= parameter is omitted, the default is 
RE. 


RW specifies that the access privilege of the 
sharable segment allows access to data and 
modification of data within the sharable 
segment. Task execution is not allowed. 


RWE specifies that the access privilege of the 
sharable segment allows access to data, 
modification of data, and task execution 
within the sharable segment. 


mO000 is the starting address of the sharable 


segment. This address is the bias address 
used to relocate relocatable addresses in the 
sharable segment. The variable an is a 


hexadecimal number from 1 through BF. If the 
ADDRESS= parameter is omitted, or ADDRESS=* is 
specified, the sharable segment becomes 
address-~independent and can be assigned a 
different starting address by each task that 
references it. If relocatable addresses are 
located in an address~independent sharable 
segment, they are relocated as though 
ADDRESS=00000 was specified and a warning 
message is issued. 


segname is a filename.ext that identifies the 
Shatable segment after it is loaded into main 
storage. This name is matched against the 
Mame specified by the tasks that are to 
reference the sharable segment. If the NAME= 
parameter is omitted, the segment name becomes 
the filename.ext of the image load module. 


It the ESTABLISH command is entered after passive commands have 


been entered, this 


BUILD AN IMAGE 
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message is displayed: 


FROM PREVIOUS INPUT?> 


If YES is entered, a build is performed. If NO is entered, 
build is performed and this message is displayed: 


*** ESTARLISHMENT ABORTED*** 


Examples: 


ES OS 


Establish an operating system image load module. 


FS SHARED,ACCESS=RE,AD=FO0000,NAME=SEG1 


Establish a sharable segmented image load module. 


ESTABLISH SHARED, ACCESS=RE,ADDRESS=A0000 


Establish a reentrant library image load module. 


ESTABLISH SHARED, ACCESS=RW,ADDRESS=* 


EStablish a task common image load module. 


no 
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3.7 EXTERNAL COMMAND 


The EXTERNAL command is a pasSive command that specifies the name 
of one or more common blocks to be referenced outside a sharable 
segment.e 


Format: 
EXTERNAL common block name,[,+-+.,common block namey | 
Parameters: 


common biock is the name of a common block to be 
name referenced outside the sharable segm2nt. See 
section 36 10% 


Functional Details: 


Common blocks are Jocal to a sharable segment unless specified by 
the EXTERNAL command. External common blocks are matched against 
external common block references in the same way external 
references are matched against entry points in a segment. 


3.8 FFILE COMMAND 


The forward file (FFILE) command is an environnent command that 
forward spaces a magnetic tape or contiguous file a specified 


number of filemarks. 
Format: 

FFILE f4 in] 
Parameters: 


fa is the file descriptor of the device to be 
forward spaced the specified number of 
filemarks. 


n is a decimal number specifying the numb2r of 
filemarks to space forward. If this parameter 
is omitted, 1 is the default. 


Examples: 


KE MAG1:,2 
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3.9 INCLUDE COMMAND 


The INCLUDE command is an active command that specifies the fila 
containing the object modules and the specific names of object 
modules that are to be included in the image load module. 


Format: 


module, module, 
CLUDE [fa]]], - peeeg nodules 
* * 


Parameters: 


I 
|= 


fd is the file descriptor of the file or device 
containing the modules to be included. Tf 
this parameter is omitted, a preassigned lu 1 
or the fd specified in the last INCLUDE 
command entered is used. If the extension is 
omitted, the default is .OBJ. 


module, is a1- to 8-character alphanumeric string 
specifying the name of the next module of a 
range of modules to be included in the image 
load module. If an asterisk (*) is specified 
or this parameter is omittei, the next module, 
relative to the position of the file, is 
included. 


moduley is a 1- to 8-character alphanumeric string 
specifying the name of the last module of a 
range of modules to be included in the image 
load module. If this parameter is omitted, 
module1 is included. If an asterisk (*) or 
hyphen (-) with no module name is specified, 
all modules starting with modulel to. the end 
of the file are included. 


Functional Details: 


If no module names are specified, all modules in the file are 
included. 
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Examples: 


INCLUDE LIBRARY.OVY 


Include all modules in fd LIBRARY.OVY. 


INCLUDE LIBRARY,FIRST 


Include the object module FIRST in fd LIBRARY.O8Jd. 


INCLUDE, SECOND-FOURTH 


Include modules SECCND through FOURTH in the fd specified 
in the previous INCLUDE command. 


INCLUDE LIBRARY.OBJ,-FOURTH,SIXTH,TENTH-* 


Include modules FIRST through FOURTH, SIXTH, and TENTH 
through the end of LIBRARY.OBJ. 
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3410 LIBRARY COMMAND 


The LIBRARY command is a passive command that specifies object 
libraries to be searched at build time to resolve external 
referencese The libraries are searched in the order they are 
hamed. 


Format: 
LIBRARY fd1i[,---,fdn | 
Parameters: 


fd is the file descriptor of the library to be 
searched. If the extension is omitted, the 
default is .OBJ. 


Functional Details: 


The libraries specified are searched for entry points that natch 
external references in the image load module being built. When 
a match is found, the object module is included. Only one pass 
is made through the list of libraries. 


External references generated py the EXTRN pseudo-op are matched 
against library entry pointse All external references generated 
from modules included from the library cause the library modules 
that resolve the external references to also be included 
regardless of the order of the modules. 


Weak external references generated by the WXTRN pseudo-op are not 
matched against the library and are only resolved to entry points 
in modules explicitly included or to modules included from a 
library through external references that are not weak. 


Non-lLinking external references generated by the INCLD pseudo-op 
are matched against module names in the library. 


Weak entry points in the library generated poy the WNTRY pvseudo-op 
are ignored during the library search. 


A module is selected from a library for the following two 
reasons: 
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1. The module is named in an INCLD pseudo-op. 
2e The module contains an ENTRY or a DNTRY which can be resolved 


against ean EXTRR in a previously included module. 


Any weak entry points contained within this newly included moiule 
also become known to LINK. Tnese weak entry points will be 
resolved against the list of unresolved externals, including both 
the standard and the weak externals. 


Examples: 
LI USER. LIB, F7RTL.OB8J 


Specifies the user run time library and FORTRAN run time 
library to be searched. 
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3-11 LOCAL COMMAND 


The LOCAL command is a passive command that specifies one or more 
entry points in a sharable segment can only be referenced within 
that segment. This command is valid only when establishing a 
sharable segment. 


Format: 
LOCAL entry point,[,.--,entry pointn] 
Parameters: 


entry point is a 1- to 8-character alphanumeric string 
specifying the entry point to be referenced 
Within that segment. 


Functional Details: 


When a sharable segment is built, all entry points can be 
externally referenced by tasks unless the entry points are made 
local to that segment by the LOCAL command. 


Examples: 


LOC ENTRY1 
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3-612 LOG COMMAND 


The LOG command iS an active command that specifies a new log 
device or starts the logging process if it was previously 
stopped. All command input, messages, and maps are sent to the 
leg device. 


Format: 


LOG fd 


Parameters: 


fd is the file descriptor of the device or file 


to receive command input, messages, and maps. 


Exampless 


LO): PEs 


LO M300: LCGFILE 
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3.13 MAP COMMAND 


The MAP command is a passive command that displays a map 
containing the names and addresses of symbols. 
Format: 
ALPHABETIC 
MAP [fd] |,-<ADDRESS 
XREF 
Parameters: 
fd is the file descriptor of the device to 
receive the MaDe If this parameter is 
omitted, the map is sent to the log device. 
However, if a log device was not previously 
specified, the maps are output to the command 
input device in interactive mode and PR: in 
batch mode. If the specified fd is not the 


Same as the log device, the map is sent to 


both e 


ALPHABETIC specifies that the map is 


symbols in alphabetical order. 


ADDRESS specifies that the map is 
symbols in address ordere 


to 


contain 


to contain 


XREF specifies that the map is to contain 


names of the modules that 


symbol. 


Functional Details: 


When the MAP command is entered, a build summary 


this information is generated: 


all 


reference 


all 


all 


the 
each 


Map containing 


e The name of the file to receive the image load modula 


e The nunber of logical records the image load module 
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contains 


The size of each overlay which includes the size of its impure 
and pure segments, common blocks, overlay tables, and total 
size 

A virtual address map containing the address and size of each 


segment 
A list of any undefined symbols 
A list of any multiple defined symbols 


A list of 


Examples: 


MAP PR; 


The build summary is sent to 


any ambiguously defined symbols 


the line printer. 


An address tab listing contains the: 

® name of 2ach symbol followed by an E CENTRY), D (DNTRY), Pp 
(PROG), or C (COMMON), 

e address of each Symbol followed by a P (pure), I (impure), or 
KR (absolute), and 

@e each overlay area grouped separately and in the order they 
were defined. 

Examples: 
MAD MAPTSTILE,ADDR 

The address map is sent to the file named MAPFILE. 


An alphabetic man listing contains thes: 

@® name of each symbol followed by an £ 
(PROG), or C (COMMON), 

® address of each symbol followed by a 
A (absolute), and 

e the name of the node containing 
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C(=NTRY), D (CDNTRY), P 


P (pure), I (impure), or 


the symbol. 
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Examples: 


MAP ,ALPHA 


The alphabetic map is sent to the log device. 


The cross reference map listing contains the names of all common 
blocks and entry points followed by the name otf the module in 
which they were defined and a list of all modules that reference 
them. 


Exampless: 


MAP PR:,XREF 
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3-14 NDCMD COMMAND 


The NDCMD is an active command that disables execution of Link 
commands imbedded in scbject modules to be included in the image 
load module. 


Format: 
NDCMD 
Functional Details: 


The DCMPD command re-enables execution of Link commands imbedded 
in object modules. See section 3.4. 
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3.15 NLOG COMMAND 


The no log (NLOG) command 


terminates logging. 


Format: 


NLOG 


Functional Details: 


Logging can be restarted by 
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the 


is 


LOG 


an 


command. 


See section 3.12. 


environment command and 


3.16 OPTION COMMAND 


The OPTION command is a passive command that sets task options 


that occur at execution time. 


Formats: 


EIASK 
OPTION a 
ULASK 


RESIDENT -\ ncrennusen | 


(PH 


N ON F 3 ‘ 
TECSAVE=< PARTIAL : 
ALL AXSVCT 


st adr ; 
. [, ENT RY¥=entry point Symbol 


7 
,dORK= /ABSOLUTE= + | » LGBLOCKS 
” om a 


rs 
i 
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Parameters: 


ETASK 


UTASK 


NAFPAUSE 


AFPAUSE 


RESIDENT 


NRESIDENT 


SESMENTED 


NS EGMENTED 


NROLL 


ROLL 


CoM 


NCOM 


CON 
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specifies that an executive task (e-task) 
image load module is to be built. An e-task 
must contain only positional-indepenient pure 
and impure code and cannot reference sharable 
segments. 


specifies that a user task (u-task) image load 
module is to be built. Lt both task 
parameters are omitted, UTASK is the default. 


specifies that the task is to continue if an 
arithmetic fault occurs during task execution. 


specifies that the task is to pause if an 
arithmetic fault occurs during task execution. 
Tf both pause parameters are omitted, AFPAJUS# 
(arithmetic fault pause) is the default. 


specities that the task is to remain in mnemory 
when it is terminated. 


specifies that the task is to be removed from 
Nain storage when it is terminated. If both 
parameters are omitted, NRESIDENT 
(nonresident) is the default. 


specifies that the pure segment of a task can 
be shared when more than one copy of the task 
is Loaded (except e-tasks). 


specifies that the pure segment of a task 
cannot be. shared when more than one copy of 
the task is loaded (except e-tasks). If both 
segmented parameters are omitted, NSEGMENTED 
(nonsegmented) is the default. 


specifies that a task cannot be rolled in and 
cut of memory during task execution. 


specifies that a task can be rolled in and out 
of memory during task execution. If both roll 
parameters are omitted, ROLL is the default. 


specifies that a task can issue intertask 
communication. 


specifies that a task cannot issue intertask 
communication. Lf both communication 
parameters are omitted, NCOM (no 
communication) is the default. 


specifies that a task can issue intertask 
control. 


NCON 


NSVCPAUSE 


SVCPAUSE 


UNIVERSAL 


NUNIVERSAL 


DISC 


NDISC 


ACP 


FLOAT 


NFLOAT 


DFLOAT 


specifies that a task cannot issue intertask 
control. Tf both control parameters are 
omitted, NCON (no control) is the default. 


specifies that all intertask communication and 
control macros entered are ignored and task 
execution continues. 


specifies that all intertask communication and 
control macros entered are ignored and task 
execution is paused. If both pause parameters 
are omitted, SVCPAUSE is the default. 


specifies that a task can communicate with all 
other tasks in the system. 


specifies that a task cannot communicate with 
all other tasks in the system. If both 
universal parameters are omitted, nonuniversal 
(NUNIVERSAL) is the default. 


specifies that a u-task has an extended disc 
privilege and can assign a bare disc. If the 
disc is on-line, assignments for 
shared-~read-only (SRO) are allowed. All other 
assignments are rejected and a message is 
displayed. If the disc is marked off-line, 
all access privileges are allowed. See the 
OS/32 Programmer Reference Manual for a 
description ot the access privileges. 


specifies that a u-task has no extend2d disc 
privileges. If both disc privileges are 
omitted, no disc (NDISC) is the default. 


specifies that a u-task has extended file 
access privileges and can specify an account 
number instead of a File class for all file 
Manajyement tunctions. 


specifies that a u-task has no extended file 
access privileges. If both access privilege 
parameters are omitted, no file access 
privileges (NACP) is the default. 


Specifies that a task can execute single 
precision floating point instructions. 


specifies that a task cannot execute single 
precision floating point instructions. If 
both tloat parameters are omitted, no float 
(NFLOAT) is the default. 


specifies that a task can execute double 
precision floating point instructions. 
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NDFLOAT 


SYSSPACE= 


WORK= 


ABSOLUTE= 


TORKLOCKS= 


PRIORITY= 


48-005 FOO RO1 


specifies that a task cannot execute double 
precision floating point instructions. Tt 
both double float parameters are omitted, no 
double float (NDFLOAT) is the default. 


lu is a decimal number from 1 through 254 
indicating the maximum quantity of logical 
units that can be assigned to a task. 


s is a 1- to 6-digit hexadecimal number 
indicating the maximum amount of system space 
that a task can use at run time. If this 
parameter is omitted, X*3000° is the default. 


Min is a 1- to 6-digit hexadecimal number 
indicating the number of bytes of main Storage 
to be added to the eni of a task for 
workspace. Each time a number is specified, 
it is added to the current minimum value. If 
an asterisk (*) is specified, the minimun 
value is reset to zero. If this parameter is 
never specified, 89 bytes (X'50') is the 
default. When a Sharable segment is being 
built, the default is 0. 


max iS a 1- to O6-digit hexadecimal number 
indicating the maximum amount (kb) of main 
storage that can be added to the end of a task 
for workspace. If this parameter is omitted, 
Z>EkKb (X'4O0CO') is the default. 


a specifies a 1- to 6-digit hexadecimal number 
indicating the number of bytes of main Storage 
to reserve for absolute data. Tf this 
parameter is omitted, the default is 256 bytes 
CX 100" 35 


b is a decimal number from 9 through 65,535 
indicating the maximum number of I/0 control 
blocks assigned to a task. Each I/9 control 
biock can contain one queued proceed [/9 
requeste If this parameter is omitted, the 
default is one. 


ipri is a decimal number from 11 through 254 
indicating the initial priority of a task. 
The initial eriority must be less than or 
equal to tne specitied maximum priority. If 
this parameter is omitted, the default is 128. 


mpri is a decimal number from 11 through 254 
indicating the maximum priority of a task. If 
this parameter is omitted, the default is the 
value used for the initial priority. 


—— ee = ee —_ aes ee 


TSW= 


ENTRY= 


TEOSAVE= 


XSVC1 


NXSVC1 


status is a 1- to 8-digit hexadecimal number 
indicating the initial setting of the status 
portion of a task's task status word (TSW). 
An O88 operation is performed on all status 
word specifications to form the final status 
word for the image load module. If the 
asterisk (*) is specified, the current TSW is 
reset to zero. If this parameter is omitted, 
the default is zero. 


st adr is a 1- to 6-digit hexadecimal number 
indicating the starting address of the address 
portion of a task's TSW. This address 
overrides the starting address at assembly or 
compilation time and the starting address in 
the ENTRY= parameter if specified in a 
previous OPTION command. 


entry point symbol is the name of an entry 
point in the root node where task execution is 
to start. Specification of an entry point 
overrides the starting address specified at 
assembly or compilation time. 


NONE specifies that no register contents are 
saved and restored by 9S/32 when entering and 
exiting a task event service routine. If this 
Parameter and the PARTIAL parameter are 
omitted, ALL is the default. 


PARTIAL specifies that only the contents of 
registers containing event data are saved and 
restored when entering and exiting a task 
event routine. If this parameter and the NONE 
parameters are omitted, ALL is the default. 


ALL specifies that all register contents are 
saved and restored by OS/32 when entering and 
exiting a task event service routine. If this 
parameter, the NONE parameter, and the PARTIAL 
parameter are omitted, ALL is the default. 


specifies that the meaning of the least 
Significant bit of an SVC1 function code being 
s2t is that an extended options fullword 
exists. This option must be specified to use 
Such features as gapless mode on. a _ 6250 
magnetic tape drive or to control the use of 
VFC on an individual I/O basis. 


specifies that the meaning of the least 
Significant bit of an SVC1 function code being 
set is that image I/0 is to be used. 


Currently, only the line printer and magnetic 
tape drivers use this option. ITAM drivers 
always operate as if xXxSVC1 is in effect. 
Other drivers always assume NXSVC1. 
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NVEC 


INTERCEPT 


NINTERCEPT 


ACCOUNTING 


NACCOUNTING 


KEYCHECK 


NKEYCHECK 


Examples: 


specifies that a task uses the vertical forms 
control option in all I/O operations. If VEC 
is omitted, NVFC (no VFC) is the default. 


specifies that a task does not use the 
vertical forms control option in allt I/0 
operations. If the VFC and NVFC parameters 
are omitted, NVFC is the default. Vertical 
forms control may still be invoked on a per LU 
basis and, if XSVC1 is specified, on a per I/0 
basis. 


specifies that this task can intercept cartain 
SVCs of another task before the SVC goes to 
the operating system for processing. If this 
parameter is omitted, NINTERCEPT is the 
default. 


specifies that this task cannot intercept the 
SVC of another task before the SVC goes to the 
operating system for processing. If the 
INTERCEP£ and NINTERCEPT parameters are 
omitted, the default is NINTERCEPT. 


specifies that OS/32 task accounting features 
are to be enabled. If this parameter is 
omitted, ACCOUNTING is the default. 


specifies that OS/32 task accounting features 
are disabled. Ls the ACCOUNTING and 
NACCOUNTING parameters are omitted, the 
default is ACCOUNTING. 


specifies that the task option keys are 
checked for a Privileged u-task or an E-task. 
If this parameter is omitted, the default is 
KEYCHECK. 


specifies that no task option keys are checked 
for a privileged u-task or an e-task. If this 
parameter and the KEYCHECK parameter are 
omitted, the default is KEYCHECK. 


OP FL,RES,NAF,LU=10,WORK=3000,TSW=(,B020) 
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3.17 OVERLAY COMMAND 


The OVERLAY command is an active command that defines an overlay 
area and specifies a level. 


Format: 


(level 
OVERLAY overlay name | o 


Parameters: 


overlay name is an 8-character alphanumeric String 
specifying the name of the overlay to be 
loaded into main storage. The name .ROOT is 
reserved for the root segment. 


level is a decimal number from 1 through 256 
specifying the number of overlays between the 
overlay being defined and the root 
(inclusive). The number specified nust be at 
most one greater than the previous level. Tf 
this parameter is omitted, the default is 1. 


Functional Details: 


This command is entered after all modules to be included in the 


root segment have been specified. Object modules to be 
positioned in an overlay area are included following the OVERLAY 
command. The sequence of defining overlays must specify the 


overlay and all its descendants before defining other overlays at 
the same level. Overlaid tasks generated by Link result in 
automatic loading cf overlays (see Section 4.4). However, 
user-controlled loading of cverlays is done by using SVC. 5. See 
the OS/32 Application Level Programmer Reference Manual. 
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Examples: 


INCLUDE ROOT.OBJ 
OVERLAY ONE,1 
INCLUDE A.ORJ 

OVERLAY THREE,2 
INCLUDE D.OEJ 
INCLUDE E.OBJ 
OVERLAY FOUR,2 
INCLUDE F.OBJ 
OVERLAY TWO,1 
INCLUDE B.OBJ 
INCLUDE C.OBJ 
OVERLAY FIVE,2 
INCLUDE G.OBJ 
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3.18 PAUSE COMMAND 
The PAUSF commard is an environment command that pauses the 
linkage editor. 
Format: 
PAUSE 


Functional Details: 


The linkage editor can be continued by entering the CONTINUE 
command. 
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3.19 POSITION COMMAND 


The POSITION command is a passive command that moves common 
blocks from their original location closer to. the root segment 
and places them in a node that will not be initialized when an 
overlay is loaded. 


Format: 


[name, pees /ame q| nodename 
POSITION COMMON= ,TO= 


* © ROOT 


Parameters: 


COMMON= name is a  %1I-= to 8-character alphanumeric 
string specifying the name of the common block 
to be moved. I[f an asterisk (*) is specified, 
all common blocks are moved. 


TO= node name is a 1- to 8-character alphanumeric 
string specifying the name of the node to 
which the blocks are to be moved. Tf this 


parameter is omitted, the blocks ar2 moved to 
the overlay node in which the POSITION ccmmand 
is encountered. If .~ROOT is specified, the 
plocks are moved to the root segment. 


Functional Details: 


The placement of common blocks in atask is determined by the 
location in which the blocks are referenced. A common block is 
initially placed no closer to the root segment than any 
Particular reference to the common block. 


Examples: 


ES TASK 

INCLUDE ROOT 

POSITION COMMON=C(A,B) 
OVERLAY OVLY1,1 
INCLUDE SUR1 

INCLUDE SUB2 

OVERLAY OVLY2,1 
INCLUDE SUB3 
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3.20 REWIND COMMAND 
The REWIND command is an environnent command that rewinds a 
magnetic tape or contiguous file. 
Format: 
KEWIND fd 


Parameters: 


fd is the file descriptor of the device to be 
rewound. 


Examples: 


RE MAG1: 
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3.21 SHARED COMMAND 


The SHARED command is an active command that specifies the name 
of the sSharakle segment to be referenced by the image load 
module. 


mOOQ00 
,ACCESS= RE ,ADDRESS= 


/STRUCTURE=(nane, [/size,] [)-++/nanen [Ystzes})| 


ees ae [nax]| )| 


Parameters: 


fd is the file descriptor of the sharable 
segment. If this parameter 1S Omitted, the 
default is a non-established task common 


seaqment defined by the operator TCOM command. 


NAME= segname is a filenane.-ext specifying the name 
of the sharable segment. Tf this parameter is 
omitted, fd must be specified, and the default 
is the name assigned to the sharable segment 
when it was created. This name is matched 
against the name of any sharable segments 
already in main storage when the task is 
loaded. If a sharable segment with this name 
is not found when the task is loaded, the 
segment name is treated as a file descriptor 
and is used to load a sharable segment. 


ACCESS= R specifies that the access privileges of the 
sharable segment allows access of data within 
the sharable segqmente Execution Or 


modification of data is not allowed. 
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ADDRES 


STRUCTURE= 


ee) 
{t 


P| 


e. 


u 


F specifies that the access privilege of the 
sharable segment allows task execution within 
the sharable segment. 


RE specifies the access privilege of the 
Sharable segment allows access to data and 
task execution within the sharable segment. 
Modification of data is not allowed. If the 
ACCESS= parameter is omitted, default is RE. 


RW specifies that the access privilege of the 
sharable segment allows access to data and 
modification of data within the sharable 
segment. Task execution is not allowed. 


RWE specifies that the access privilege of the 
sharable segment allows access to data, 
nodification of data, and task execution 
Within the sharable segment. 


mOCOO is the starting address of the sharable 
segment. If the sharable segment specifies a 
file descriptor and the sharable segment is 
not address independent, the specified address 


must match the address specified in the 
Sharable segment. If this parameter is 
omitted or not specified in the sharable 
segment, Link assigns an address to the 


Sharable segment. 


name is an 8-character alphanumeric string 
specifying the name of the task common block 
to be placed in the sharabie segment. 


Size is a hexadecimal number specifying the 
length of the task common block. This aumber 
must be greater than or equal to the size of 
the common block. If this number is smaller 
than the current size of the task common 
block, a message is displayed and the size of 
the task common block is used. If this 
parameter is omitted, the default is the size 
of the task common block. 


min is a i- to 6-digit hexadecimal number 
Specifying the minimum number of pytes of main 
storage to he occupied by the sharable 
seqmente If this parameter and the fd 


Parameter are omitted, the default is the 
total number of bytes of all common blocks 
specified in the STRUCTURE= parameter or the 
size of segment as e@sStaplished. If this 
parameter is omitted and the fd parameter is 
specified, the default is the number of bytes 
specified when the sharable Segment was built. 
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max is a 1- to 6-digit hexadecimal number 
specifying the maximum number of byt2s of nain 
storage to be occupied by the sharable 
segment. If this parameter and the fd 
parameter are omitted, the default is the 
total number of bytes of all common blocks 
specified in the STRUCTURE= parameter. If 
this parameter is omitted and the fd parameter 
is specified, the default is the number of 
bytes specified when the sharable segment was 
built. 


Functional Details: 


When the task referencing the sharable segment is loaded, the 
user-specified minimum and maximum values are compared with the 
actual size of the sharable segment. If the actual size is 
smaller than the specified minimum value, a message is displayed 
and the task is not loaded. If the actual size is larger than 
the specified maximum value, only the specified maximum value is 
available. If the sharable segment references other sharable 
segments, these references are automatically included in the 
image load module. However, these secondary references need not 
be declared again by using the SHARED command. 


Examples: 


ESTABLISH SHARED, NAME=SEGMENT.ACC,ACCESS=RW 
INCLUDE COMY 

BUILD COMX 

END 


ESTABLISH TASK 

SHARED COMX,STRUCTURE=(COMX) 
INCLUDE PROG1 

BUILD PROG1 

END 


ESTABLISH SHARED, NAME=SEGMENT.ACC,ACCESS=RE,ADDRESS=E90000 
INCLUDE LIB1 

INCLUDE LIB2 

BUILD LIBX 

END 


ESTABLISH TASK 
SHARED LIBX 
INCLUDE PROG1 
BUILD PROG1 
END 
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3.22 TITLE COMMAND 


The TITLE command is an environment command that specifies the 
heading to be printed at the top of all maps. 


Formats: 


TITLE title 


Parameters: 


title 


Functional Details: 


is a 60-character alphanumeric string 
specifying the title to be vrinted at the top 
of all maps. If the title contains a blank, 
comma, or semicolon, it must be enclosed 
within Single quotation marks. 


The TITLE command remains in effect until a subsequant TIILE 
command is specified. 


Examples: 


TI PERKIN-ELMER 


TI *DEPARTMENT 


3086' 
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3.23 VOLUME COMMAND 


The VOLUME command is an environment command that specifies the 
volume to be used by the linkage editor when a volume is omitted 


in a file descriptor. 


Format: 


Parameters: 


voln is the name of the volume to be useij by the 


linkage 


editor as the default. If tais 


parameter is omitted, the current default 


volume 
device. 


Functional Details: 


The VOLUME command remains 
command is specified. 


Examples: 


VO M4309 
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is displayed on the command input 


in effect until a subsequent VOLUME 


3.24 WFILE COMMAND 


The WFILE command is an environment command that writes a 
filemark on a magnetic tape or contiguous file. 


Format: 


WEILE fd [nn] 


Parameters: 
id is the file descriptor of the device to which 
a filemark is to be written. 
n is a decimal number specifying the number of 


filemarks to be written. If this parameter is 
omitted, 1 is the default. 


Examples: 


WE MAG13:,2 
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CHAPTER 4 
BUILDING EXAMPLES OF IMAGE LOAD MODULES USING LINK 


4.1 INTRODUCTION 


This chapter explains the basic concepts required to use the 
linkage editor through examples showing sample command build 
sequencese See Chapter 3 for detailed information on the Link 
commandSe 


4.2 BUILDING A SIMPLE TASK IMAGE LOAD MODULE 


This example includes an object module with no external 
references called MOD1.CBJ, produced by the CAL Assembler, and 
builds a task image load module. For examples: 


INCLUDE MOD1 
MAP. oP es 
BUILD MOD1 
END 


The INCLUDE command specifies that all the object modules in the 
input file MOD1.08J are to be included in the build. The file 
extension .~.OBJ is the default extension for the INCLUDE command 
which is an active command and is executed immediately. 


The MAP command specifies that a build summary is to be printed 
on the output device (PR1:). The MAP command is a passive 
command and is executed only when the BUILD command is entered. 


The BUILD command builds the inage load module and stores it in 
file MOD1.TSK.e. The file extension .TSK is the default extension 
for the BUILD command. The BUILD command is an active command 
and is executed immediately. 


The END command is an active command and terminates the linkage 
ecitor. 
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4.3 BUILDING MORE COMPLEX TASK IMAGE LOAD MODULES 


This section discusses building COBOL and FORTRAN task image load 
modules, using subroutine libraries, maps, the OPTION command, 
and object modules containing imbedded Link commands. 


4.3.1 Building a COBOL Task Image Load Module 


This exampie includes an object module containing external 
references called MCD2.08J produced by the COBOL compiler. The 
task image load module to be built is to include the 
Single-precision floating point capability. A map is to be 
generated listing the names and locations of all modules and 
entry roints in address order. 


INCLUDE MOD2 
LIBRARY COBOL.LIB 
OPTION FLOAT 

MAP PR1:,ADDRESS 
BUILD MOD2.TSK 
END 


The INCLUDE command specifies that all the object modules in the 
input file MOD2.OBJ are to be included in the build. 


The LIBRARY command specifies that tne COBOL run time library 
file CORBOL.LI8 is td be searched, and any routines that contain 
entry points matching unresclv2d external references are to be 
included in the task image load nodule. The LIBRARY command is 
a PasSive command and causes the specified library to be searched 
when the build process occurse 


The OPTION command specifies that the Single-~precision floating 
point caMability is to he included as part of the task image load 
module. 


The MAP command specifies that a puild summary anda listing of 
the names and locations of all modules and entry points in 
address order are to be generated. 


The BUILP command builds the task image load module and stores it 
in file MUD2?.TSKe 


The #ND command terminates the linkage editor. 


4.3.2 Building a FORTRAN Task Image Load Module 


This example includes an object module containing external 
references called MOD3.03J produced by the OS/32 FORTRAN VII 
Compiler and builds an image load module. The image load module 
to be built is to include both single and double precision 
floating point cadabilities, and additional workspace for the 
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user and FORTRAN run time libraries. A map is to be generated 
listing the names and locations of all modules, common blocks, 
and entry points in alphabetical order. Also a cross reference 
of all entry points and the modules referencing them is to be 
generated. 


INCLUDE MOD3 

LIBRARY USERLIB,FV7RTL 

OPTION DFLOAT,FLOAT,WORK=A09 
MAP PR1:,ALPHABETIC,XREF 
BUILD MOD3 

END 


The INCLUD& command specifies that the main task in the input 
file MOD3.083J is to he included in the build. 


The LIBRARY command specifies that the user library file USERLIB 
and FORTRAN run time library file F?7RTL are to be searched in the 
order that they are named and that any routines containing entry 
points matching unresolved external references are to be included 
in the task image load module. 


The OPTION command Specifies that the single- and 
double-vrecision floating point capabilities and additional 
workspace for the run time libraries are to be included as part 
of the task inage load module. 


The MAP command specities that a build summary and an 
alphabetical listing of the names and locations of all modules 
and entry points are to be generated. A cross reference of all 
entry points and modules referencing them is also to be 
generated. 


The BUILD command builds the task image load module and stores it 
in file MOD3.TSK and the END command terminates the linkage 
editor. 


4.3.3 Building a COBOL Task Image Load Module with Link 
Commands Imbedded in Object Modules 


This example includes an object module, MOD4.O0BJ, containing 
external references and imbedded Link commands produced by the 
COROL compiler, and buiids an image load module. The image load 
module to be built will include singlée- and double-precision 
floating point capabilities and additional workspace for the user 
and COBOL run time libraries. An alphabetical map will be 
Generated listing the names and locations of all modules, common 
blocks, and entry points. Also a cross reference of all entry 
points and the modules referencing them will be generated. 
Execution of all imbedded Link commands is disabled in MOD4 by 
the NDCMD command and enabied by the DCMD command in the library 
modules. Multiple ccmmands are entered on one line Separated by 
a semicolon, and comment lines are used by preceding the comment 
with an asterisk. 
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NDCMD;*IGNCRE IMBEDDED COMMANDS IN MODY 

INCLUDE MODS;LIBRARY USERLIB,COBOL.LI8 

OPTION DFLOAT,FLOAT,WORK=A00 

MAP PR1:,ALPHABFTIC,XREF 

DCHD;*PROCESS IMBEDDED COMMANDS IN LIBRARY MODULES 
BUILD MOD4 

END 


Link accepts passive commands that have been compiled Or 
assembled into an object module. These commands are treated as 
if they occurred at the point where the module is included. 
Therefore, passive commands imbedded in object modules referenced 
by an INCLUDE commani are treated as if they were entered 
immediately after the INCLUDE conmand. Commands imbedded in 
object modules referenced by a LIBRARY command are treated as if 
they were entered immediately before the next BUILD command. The 
NDCMD command causes all subsequent imbeddei commanis to be 
ignored and the DCM0 command reenables this feature. 


4.4 BUILDING OVERLAID TASK IMAGE LOAD MODULES 


This section discusses building overlaid task image loai modules 
uSing subroutines, root segments, overlay areas, root nodes, and 
overlay nodes. This overlay feature allows a task to be broken 
into sections so jt can be executed using less main Storage than 
its total size. 


4.4.1 Building a Simple Overlaid Task Image Load Module 


This example includes an object module called MOD5.90BJ which 
consists of a main task that calls three subroutines (SUBA, SU8B, 


and SUBC). These subroutines do not reference each other and 
overlay 10kb of the same main storage area if each subroutine is 
loaded only when needed. The main task occupies 10kb of main 


storage, and the largest overlay occupies 10kb of main storage 
which is a total of 20k5b for the whole task. This task wouid 
occupy 40kb of main storage without using the overlay feature. 
The MAP command specifies that a build summary anda listing of 
the names and locations of all modules and entry points in 
address order are to be generated. It is assumed that all the 
routines are contained in file MSP.OBJ. 


INCLUDE M3003:MSP.OBJ,MOUS 
OVERLAY A 

INCLUDE ,SUBA 

OVERLAY B 

INCLUDE ,SUBB 

OVERLAY C 

INCLUDE ..SUBC 

MAP PR1: ,ADDRESS 

BUILD MOD5 

END 


4-4 48-095 FOO R01 


The INCLUDE command specifies that the object module MOD5.0ORJ in 
the input file MSP.OBJ is to be included in the build. Because 
no overlays have been specified by the OVERLAY command, MOD5.90BJ 
becomes the main task (root segment) and is placed in the root 
nodeée 


The first OVERLAY command defines an overlay area namei A. The 
INCLUDE command specifies that the object module called SUJBA is 
part of overlay A and will be automatically loaded into main 
storage if it is not already loaded when HOD5 calls SUBA. The 
overlay can be explicitly loaded by issuing an SVC 5 in assembly 
language or CALL IFETCH in FORTRAN. 


The second OVERLAY command defines an overlay area named B. The 
INCLUDE command specifies that the object module callad SUBR is 
part of overlay B and will be automatically loaded into the same 
malin storage area previously occupied by overlay A, if SUBB is 
not already loaded when MODS calls it. 


The third OVERLAY and INCLUCE commands define an overlay area 
named Cc and includes the object module called SUBC as part of 
overlay C. 


The MAP command specifies that a build summary and a listing of 
the names and locations of the main task (root segment) and all 
subroutines (overlay areas) in address order are to be generated. 
A map of each overlay area is also produced. 


The BUILD command Enuilds the image load module called MOD5.TSK 
which consists of a root segment (MOD5.0OBJ), an overlay area 
large encugh to contain the largest overlay (A, 8B, and C), and 
the Subroutines (SUBA, SUBB, and SUBC). The END command 
terminates the linkage editor. 


“e4U.2 Building a More Complex Overlaid Task Image Load Module 


This example includes an cboject module called file LFP.OBJ. 
which consists of a main task that calls two subroutines (SuUBA 
and SURR). Subroutine SYBA calls two more subroutines (SUBA1 and 
SUBA2). Subroutine SUBB also calls two more subroutines (SUBB1 
and SUB&82). In addition to SUBA and SUBB overlaying each other, 
SU8A1 and SUBA2 are to be overlaid when SUSA is in main storage, 
and SU881 and SUEB2 are to be overlaid when SUBB is in main 
storage. This overlay process can be accomplished by using 
another level of overlay areas. Figure 4-1 illustrates the 
overlay structure for this examcle. 
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| MOD5 { 


~— oe ee oe ee am ew ar ee oe we 


Level {| SUBA | } SUBB | 
1 } (node A) | { (node D) | 
| | 
| | 
| 
gina cc earner ete ets Penne sae. 
{ | | 
Level [{ SUBA1 ] | SUBA2 | | SUBB1 | { SUBB2 { 
2 |} (node B) { {| (node C) | | (node E) | | (node F) | 


Figure 4-1 Sample Overlay Structure 


A path is defined as a set of nodes (a group of routines loaded 
at one time is a node), one at each level, each of which is a 
descendant of the node at the previcus level. For example, the 
root node, node D, and node £ form a path. Only nodes in the 
Same path may be in memory at the same time and, therefore, a 
routine may only call routines in nodes which are in the same 


path as the node containing the calling routine. 


The overlay nodes may be different sizes and the total overlay 
area required at any one time is the total size of all the nodes 
in the current path. The size of the overlay area for the task 
is determined by the path with the largest total size. 


It is assumed that all the Subroutines are contained in file 
LFP.OBJ. Utility routines called in the task are in USERLIB.OBJ. 


INCLUDE M300:LFP.OBJ,MOD6 
OVERLAY A,1 
INCLUDE ,SUBA 
OVERLAY R,2 
INCLUDE ,SUBA1 
OVERLAY C,2 
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INCLUDE ,SUBA2 
OVERLAY D,1 — 
INCLUDE ,SUBR 

OVERLAY E,2 

INCLUDE ,SUBB1 

OVERLAY F,2 

INCLUDE ,SUBB2 

LIBRARY USERLIB 
MAP PR1:,ADDRESS 
BUILD MOD6 

END 


The INCLUDE command specifies that the object module MOD6 in the 
input file LFP.OBJ is to be included in the build. MOD6 becomes 
the main task (root segment). 


The first CVERLAY command defines an overlay area named A with a 
depth level of one. The INCLUDE command specifies that the 
object module called SUBA is part of overlay A. All descendants 
of overlay A must be specified before any other overlays with a 
depth level of one are defined. 


The second and third OVERLAY commands define overlay areas named 
B and C with a depth level of two which indicates that these 
overlays are descendants of overlay A. 


The fourth OVERLAY command defines an overlay area named D with 
a depth level of one. 


The fifth and sixth OVERLAY commands define overlay areas named 
E and F with a depth level of two which indicates that these 
overlays are descendants of overlay D. 


The LIBRARY command specifies that the user library file USERLIB 
is to be searched and any routines containing entry points 
matching unresolved external references are to be included in the 
overlay structure being built. If a particular overlay area 
contains external references te a routine in the user library, a 
copy of that routine is placed in the referencing overlay area 
unless the referencing overlay area is a descendant of an overlay 
area that already contains a copy of that particular routine. 


If modules SUBA1 and SURA2 reference a routine called TAG located 
in the user library, a cory of routine TAG is included in overlay 
areas B and Ce. However, if modules SUBB and SUBB1. reference 
routine TAG, a copy of the routine is only included in overlay 
area De. If the main task MCD6 references routine TAG, a copy of 
the routine is only included in the root segment regardless of 
any other overlay areas referencing it. However, if two copies 
of a routine are to be included in two overlay areas (one being 
a descendant of the other), that routine must be explicitly 
included by the INCLUDE command. 


The MAP command specifies that a build summary and a listing of 
the names and locations of the main task (MOD6) and all 


48-005 FOO RO1 . 4-7 


subroutines (SUBA, SUBA1, SUBA2, SUBB;, SUBEB 17 and SUBB2) in 
address order are to be generated. 


The BUILD command builds the image load module which consists of 
the root segment, overlay areas, and the subroutines. The END 
command terminates the linkage editor. 


4.4.3 Moving Common Blocks 


Normally, the placement of common blocks ina task is determined 
by where they are referenced. For example, if ALPHA is a common 
block referenced by routines in a particular node, ALPHA is 
included in that node. 


If ALPHA is referenced by routines in more than one overlay node, 
ALPHA is included in the numerically highest level node of the 
path in with each node references ALPHA. This is subject to the 
restriction that ALPHA is not referenced ina numerically lower 
level node than the one in which it is placed. 


If SUBA1 and SUBA? both reference ALPHA, it is placed in node A. 
If routines SUBA2 and SUBB1 reference ALPHA, ALPHA is placei in 
the root node. 


In some cases, it is desirable to place a common block ina node 
other than the one in which it would normally be placed which is 
where it is referenced. For example, placing a common block in 
the root node prevents the data in it from being reinitialized 
each time the node in which it is located is loaded. 


This example moves a common block called BETA, which is 
referenced by routines in modules SUBA2 and SUBB1 in Figure 4-1, 
to the root node in the overlay structure by using the POSITION 
command. 


INCLUDE M300:LFP.OBJ,MOU6 
OVERLAY A,1 


LIBRARY USERLIB 
POSITION COMMON=BETA,TO=.ROOT 


END 


This conmand specifies that the common block named ALPHA is to be 
placed in the root nodee Only one copy of a common block can 
occur in a task and an error results if an attempt is made to 
position a common block in a node that is at a numerically higher 
level or not in the same path as the node in which it would 
normally be placed. 
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4.5 BUILDING SHARABLE SEGMENTS 


Sharable segments, such as blockdata modules and run time 
libraries, must be separately built by Link to be used or 
referenced by established tasks. This example includes two 
blockdata object modules called BDALPHA.OBJ and BDBETA.OBJ to 
initialize common blocks called ALPHA and BETA. 


This example also includes an object file called F7RTL.OBJ to be 
included in a second build. The shared segment to be built is to 
include local and external entry points and additional workspace 
for the FORTRAN run time library. 


ESTABLISH SHARED, ACCESS=RW,NAME=COMMONS 
INCLUDE BDALPHA.OBJ 

INCLUDE BDBETA.OBJ 

EXTERNAL ALPHA,BETA 

BUILD COMMONS.SEG 

*THIS COMMAND SEQUENCE STARTS THE SECOND BUILD 
ESTABLISH SHARED, ACCESS=RE,ADDRESS=F0000 
INCLUDE FVRTL.OBJ 

LOCAL .DI,.DO,.TGD, -TASKID, .HYDEX,-HYEXP 
OPTION WORK=A00 

BUILD FU7RTL.SEG 

END 


The first ESTABLISH command specifies that the sharable segment 
to be built is called COMMONS.SEG with read/write access 
privileges. The ACCESS and NAME parameters provide information 
that is verified against the parameters specified in a 
referencing task‘s SHAR#ED command or the defaults if no SHARED 
command iS Specified ina referencing task. For example, if a 
subsequent SHARED command in a referencing task specifies 
read-only access and a name of COMMONS, the access is allowed 
because it is a subset of the maximum access specifiei in the 
previous example and the name COMMONS matches the name specified 
in the previous example. A request for execute access would be 
rejected. 


The first two INCLUDE commands include the blockdata object 
modules called BDALPHA.OBJ and BDBETA.OBJ. 


The EXTERNAL command specifies that the two common blocks ALPHA 
and BETA are tc be known outside the sharable segment. . 


Normally, common blocks are considered locale Note that either 
the STRUCTURE parameter in a subsequent SHARED conmand in a 
referencing task or the EXTERNAL command ,not both, are required 
to match up the common references in a task with the initialized 
common blocks in the sharable segment named COMMONS. The 
EXTERNAL command is passive. 


The first BUILD command builds the sharable segment in file 
COMMONS.SEG. 
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The second ESTABLISH command specifies that a new sharable 
segment is to be built called F7RTL.SEG with read-execute access 
privileges only and a starting address of X'FOO00° within the 
task referencing ite The ADDRESS parameter specifies that this 
segment is to start at FOQ000 in the address space of any task 
which references it. Segments that do not specify an address in 
either the SHARED command of the referencing task or the 
ESTABLISH command of the segment are address independent and may 
be allocated anywhere within the address space of tasks which 
reference them. 


The third INCLUDE command includes all the FORTRAN run time 
library routines in F7RTL.CBJ in the sharable segment to be 
built. 


The LOCAL command defines that the entry points .DI, DO, eTSD, 
eTASKID, eHYDEX, and .HYEXP are local to the segment and cannot 
be referenced by tasks referencing the sharable segment. 


The OPTION command specifies that additional workspace for the 
run time library is to be included in the sharable segment when 
any task references this segment. 


The second 2UILD command builds the sharable segment and stores 
it in file FV7RTL.SEG. The END command terminates the linkage 
editor. 


Sharable segments can also be created by the operator at the 
system console if it is to be used as an area for common blocks. 
These sharable segments do not require loading into main storage 
or initialization before they can be referenced by other tasks. 


4.6 BUILDING A TASK IMAGE LOAD MODULE REFERENCING SHARABLE 
SEGMENTS 


Link provides the capability of sharing one copy of a segment 
containing code and/or data areaS among multiple tasks. In 
particular, shared common blocks allow data to be shared or 
communicated among tasks. Shared copies of tun time libraries 
allow more efficient use of main storage. 


This example builds a FORTRAN task. MOD7.0BJ is a FORTRAN 
program that references a Sharable Segment containing two common 
blocks called D#LTA and GAMMA and the FORTRAN run time library. 


INCLUDE MOD7 

SHARED COMMON.SEG,NAME=COMMONS, ACCESS=R, 
CONTINUEDSSTRUCTURE=(DELTA/1000,GA MMA ) 
SHARED F7RTL.SEG 

MAP PR1:,ADDRESS 

BUILD MOD7 

END 
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The INCLUDE command specifies that the object module MOD7.OBJ is 
to be included in the build. 


The first SHARED command specifies that COMMON.SEG is the file 
containing a sharable segment called COMMONS which consists of 
the two common blocks, DELTA and GAMMA. The access privileges 
are read-only. Because a comma is the last character entered on 
the line, the CONTINUE> prompt is displayed in interactive mode 
and the remaining parameters are entered. The STRUCTURE 
parameter specifies that the first 1000 bytes of the segment 
COMMONS is to be allocated for the common block DELTA, regardless 
of the size of DELTA in the program. The area after the first 
1000 bytes is to be allocated for the common block GAMMA. The 
parameters in the SHARED command are compared against the 
information in the file COMMON.SEG. Any information not provided 
by the parameters is taken from the file or defaulted. At run 
time, the pre-initialized segment is loaded from the file. 


The second SHARED command specifies that another shared segment 
is to be .loaded from the file F7RTL.SEG. All of the other 
parameters default to information contained in the file. 


The MAP command specifies that a build summary anda listing of 
the names and locations of all modules and entry points in 
address order are to be generated. 


The BUILD command builds the task image load module and stores it 
in the file MOD7.TSK. The sharable segments are referenced to 
resolve external references and to determine the placement of 
common blocks. The sharable segments are stored as separate 
files and are not included as part of the load module. The END 
command terminates the linkage editor. 


4.7 BUILDING AN OPERATING SYSTEM IMAGE LOAD MODULE 


This example includes an object module called MTSYSTEM.OBJ with 
external references produced by the Library Loader and builds an 
image load module. A map is to be generated listing the names 
and lecations of all symbols, tasks, and entry points in 
alphabetical and address order. 


ESTABLISH OS 

INCLUDE MTSYSTEM.OBJ 

MAP PR1:,ADDRESS,ALPHABETIC 
BUILD OS32R0n-0090 

END 


The ESTABLISH command specifies that the image load module to be 
built is to be an operating system load module. 


The INCLUDE command specifies that the input file MTSYSTEM.OBJ 
contains the object module to be included in the build. 
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The MAP command specifies that a build summary and a listing of 
the names and locations of all modules and entry points in 
alphabetical and address order are to be generated. 


The BUILD command builds the operating system image load module 
and stores it in the file OS32R0n.000 which can be loaded into 
main storage by the BOOT or LSU. The END command terminates the 
linkage editor. 
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APPENDIX A 
LINK COMMAND SUMMARY 
BEILE fd [,n] 
BUILD ¢4 
DCMD 


“RE Jbapozess-} 


* 


f 
ESTABLISH R 
| "2 


EXTERNAL common block nama, [¢eee,common block name | 


FFILe tar] 


| module, module, 
INCLUDE [£ dj ° i ceoer,module, 
* é 


* 


LLBRARY £4, [,-0+,fdn | 


I 


CCAL entry point, [s+ entry point ,|. 
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ALPHABETIC 


MAP [£d] |,<ADDRESS 


{P< 


REF 


oO 

a ©] 

tar | 

He 

oO 

= 
ame em, 
ie i 


: aus to ! Pisosink 


| srentanent 
: NSEGMENTED: 


LOAT “lL a900 
min max 
‘ae! {* 
7WORK=] ¢ * 4 4 4 * ,ABSOLUTES. , LOBLOCKS 
100 3 
ipri at 
»PRIORITY= po 
aa ‘eae § 


48-005 FOO R01 


level 
CVERLAY overlay name|,< | 
Ae 


PAUSE 


[Rame 4 peeername gy nodename 
POSITION COMMON= rahe 


* 


SHARED [ed] [,NAME=segnanme] 
R 


E 
mQ000 
7ACCESS= RE j apoRess- | 


RW 
RWE 


|-snsuceur E= (nane, size] E eeorsnamey [/sizea]| 
[S125 ([min Fax4])] 


TITLE title 
VOLUME [voin] 


WEILE fd [fn] 
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APPENDIX B 
LINK MESSAGE SUMMARY 


ACCESS PRIVILEGE CONFLICT IN SHARABLE SEGMENT 


Access privileges of a segment being referenced should be a 
higher privilege level than the access privileges specified 
when the segment was defined. 


ADDRESS OVERFLOW AT xxxxxx 


A halfword relocatable address was larger than 64kb. 


ATTEMPT TO POSITION x IN A DIFFERENT PATH 


An attempt was made to position a common block that is in a 
different path than the node referencing it. 


ATTEMPT TO POSITION x IN LOWER LEVEL NODE 


An attempt was made to reposition a common block o»rogram in 
a lower level node. 


BUILD NOT SUPPORTED ON THIS DEVICE 


Other than an indexed or contiguous file was specified for 
building the image. 


CHECKSUM ERROR FILE: % MCDULE: y RECORD: 2z 


An invalid checksum was detected while reading an object 
file. 


COMMAND NOT PERMITTED 


Command is not valid for the type of build or not permitted 
in a DCMD statement. 
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COMMON BLOCK x ENCOUNTERED IN MORE THAN ONE SHARABLE SEGMENT 


The same common block was specified in more than one SEGMENT 
command. 


COMMON BLOCK x, NOT REFERENCED 


The common black named was never referenced. 


COMMON BLOCK x SPECIFIED IN POSITION COMMAND IS PART OF SHARABLE 
SEGMENT 
An attempt was made to reposition a common block that was 
part of a sharable segment by using the POSITION command. 


CONTINUATION NOT PERMITTED 


An attempt was made to continue a command imbedded in the 
object code. 


ENTRY POINT x SPECIFIED IN ENTRY OPTION NOT FOUND 
The FNTRY parameter of the OPTION command specified a 


nonexistant entry point or an entry point in other than the 
root node. 


ENTRY POINT x, SPECIFIED IN LOCAL COMAND, NOT DEFINED 


The entry point named was never defined. 


ESTABLISHMENT ABORTED 


A serious error occurred, and the image module cannot ope 
built. Link is cleared as if a moadule was built. 


EXTERNAL REFERENCE TO OVERLAY CONTAINS OFFSET AT xxxxxx 


An external reference with offset cannot be resolved because 
the corresponding entry point is an overlay. 


EXTRA RIGHT PARENTHESIS 


Fither an extra right parenthesis or a missing left 
parenthesis condition occurred. 
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fd NOT FOUND 


An assignment error occurred while Link attempted to assign 
the specified file. 


INCORRECT PARAMETER LENGTH 


The Length of the value of an operand was longer or shorter 
than expected. 


INSUFFICIENT WORK SPACE 


There was not erough workspace for Link. It will return to 
command mode and clear itself as if an image had been built. 


INVALID CHARACTERS IN NAME 


Invalid characters in an entry point, common block, or 
overlay node name were encountered. 


INVALID COMBINATION OF OPERANDS 


A particular combination of operands was invalid. 


INVALID COMMAND 


An invalid command was specified. 


INVALID DELIMITER 


A delimiter that was unknown was found at the end of a 
Parameter or where a Barameter shauld have been. 


INVALID FILE-DESCRIPTOR 


A syntax error occurred in the fd entered. 


INVALID KEYWORD 


Misspelled keyword. 


INVALID NUMERIC VALUE 


A numeric value was expected but was not encountered. 
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INVALID PARAMETER 
An invalid wvarameter was specified in a command. 

INVALID POINTER TO LOCATION xxxxxx ENCOUNTERED IN 

REFERENCE CHAIN FOR xxxxxx AT LOCATION xxxxxx 

THIS INVALID POINTER ERROR OCCURRED IN 

- FILE: vol:filename.ext/a - MODULE: module 

- RECORD: number - BYTE number 
LINK encountered an invalid link in an address chain. When 
LINK resolves a chain of references, it traces back through 
the chain, link by link, replacing the chain pointer with the 
resolved address of the object. If a chain has a forward 
pointer within a module or if a pointer indicates an area 
outside of the module, LINK ceases to follow this chain, 


leaving the remainder of the chain unresolved, and prints the 
error message above. 


ITEM NOT PERMITTED IN E-TASK FILE: x MODULE: y RECORD: 2z 
BYTE: m 


The loader item encountered is not allowed in an e-task 
establishment. 


MISSING PARAMETER 


A required parameter was not specified. 


MISSING RIGHT PARENTHESIS 


A left parenthesis was encountered for which no matching 
right parenthesis was encountered. 


MODULE INCOMPLETE FILE: x MODULE: y 


An end-of-file condition was detected before the 
end-of-program item in an object module. 


MODULE xxxxxxx NOT FOUND 


A module specified in an INCLUDE command was not found. 


MORE THAN 192 SEGMENTATION REGISTERS REQUIRED 


More than 192 segmentation registers are required. 
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n MULTIPLY DEFINED SYMBOLS 
Entry points were encountered that were defined more than 
once in the same path. 

n UNDEFINED EX TERNAL SYMBOLS 
This message is output at build time if any standard external 
symbols remain unresolved. 

**k** nnn UNDEFINED WEAK EXTERNAL SYMBOL(S) *** 
This message is output at build time if any weak external 
symbols remain unresolved. 

name SPECIFIED IN POSITION COMMAND NOT FOUND. 
A common block that was specified on a POSITION command could 
not be found. 

NUMERIC VALUE OUT OF RANGE 
A numeric operand was greater than the maximum permissable 
value or less than the minimum permissable value. 

OBJECT CODE ERROR (n) FILE: x MODULE: y RECORD: z BYTE mn 
An object code error cccurred. If n=1, an invalid object 
code item exists in object record. If n=2, the object code 
item overflows record. If n=3, a load program address item 
was expected but not encountered. 

OVERLAY DEFINED OUT OF ORDER 
An OVERLAY command specifies a level that is not consistent 
with the rules for defining overlays. 

RECORD LENGTH FOR MAP LESS THAN 64 DEVICE/FILE 
The device or file specified for the output of the maps has 
a record length less that 64 bytes. 

SEGMENT AT x OVERLAPS NEXT SEGMENT 
An impure, pure, or sharable segment's end addiresS was 


greater than the end address of another segment. See the 
build summary map for the names of the segments. 
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SEQUENCE ERROR FILE x MODULE: y RECORD: Z 
A sequence number error was detected while reading an object 
module. 

TOO MANY OPERANDS 


More operands than were expected were encountered. 


VIRTUAL SYMBOL TABLE SPACE LIMIT EXCEEDED 


More than 256K symbol table space required. 


WARNING: ABSOLUTE SPACE LESS THAN 100 


Less than 100 bytes of absolute code was reserved for the 
UDL. 


WARNING: MORE THAN 16 SEGMENTATION REGISTERS REQUIRED 


More than 16 segmentation registers were used, making this 
image loadable only on a processor with greater than 1MB of 
MEMOLY. 


WARNING: n AMBIGUOUS REFERENCES 


External references were encountered that could be resolved 
to more than one entry point. 


WARNING: OVERRIDE SIZE FOR COMMON BLOCK x SMALLER THAN ACTUAL 
SIZE 


The override size specified in the STRUCTURE parameter of the 
SEGMENT command was smaller than the largest definition of 
the common block. 


WARNING: NAME OF SHARABLE SEGMENT x DOES NOT MATCH NAME 
SPECIFIED IN SHARED COMMAND 


The name given to a Sharable segment when it was linked does 
not match the name specified in the NAME parameter of the 
SHARED command. The name specified in the SHARED command is 
used. 


x ERROR Cy) ON z TO fd 
An SVC 7 error occurred. Variable x is the type of error, y 


is the hexadecimal status, z is the SVC 7, and fd is the 
file. See Table B-1 for the error types and status. 
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TABLE B-1 SVC 7 ERROR TYPES AND STATUS 


| FUNCTION | ERROR TYPE | HEX STATUS | | 
| Zz | x | y | MEANING | 
| pe eRe nN er a a i i i a a a a a er ene | 
} ALLOCATE | VOLUME | 3 | Volume was not specified. | 
| ASSIGN (Seas Sse eee eS ae eae Se vay ee en eee ere ye | 
| DISC SPACE | 5 |} Insufficient disc space | 
| CLOSE | | | available to allocate or | 
| | | } assign a file. { 
| DELETE si aa oa a ta ae ad eases eS See SSeS Ss SS SSeS iS | 
| | PROTECTION | 6 | File being assigned had | 
| FETCH |} KEY | | nonzero protection keys. | 
VATTRISULES boa ===4525Sse—Se sees SSeS SSS See PSS Ss SSS ews Sees | 
| | ACCESS | 7 | Specified access privi- | 
| | PRIVILEGE | } leges could not be | 
| | | | granted. | 
ieccteietonas aa ia ey aan ea a 
| | SYSTEM | 8 | Insufficient system | 
| | SPACE | | space available. | 
| ace ee eis ins Sere a oe ae ee | 
| SVC 7 | 9-FF | An SVC 7 error occurred 

| 


| | {| other than the errors | 
| | | specified above. | 


ee we we ee ee ee ee i we ew = ot ow om oe om om ce oem oe om ot oe om ee om om om am oe om om om oe i ow we wm ww oe we we i ww we ee ee ow es 


x ERROR (Cy) ON z TO LU n FILE fd 


An SVC 1 error occurred. Variable x is the type of error, y 
is the hexadecimal status, zis the function that was being 
performed, and nis the lu number. See Table 8-2 for the 
error types and status. 
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TABLE B-2 SVC 1 ERROR CODES AND STATUS 


{| FUNCTION | ERROR TYPE | HEX STATUS | . | 
| Zz | x | Yy | MEANING { 
re | 
} READ | DEVICE | AO | Device has been turned | 
| | UNAVAILABLE | | off. | 
| WRITE (SH e He era Sao SSS See ar 8 eS SS eS SSeS Se eS a | 
| | END OF | 99 | End of tape or disc | 
} COMMAND | MEDIUM | {| encountered. | 
| eee ee Ree or eae tree gente s | 
| | END OF | 88 } End of tape or disc | 
| ! FILE | {| encountered. | 
| Waray aici efecto nie taee aa Glassen ema Se | 
| | UNRECOVERABLE] 84 } An unrecoverable error | 
| | | | occurred. | 
|  ecidaleoeaustac ei aii aes sae regio as anes 95s eee | 
| [RECOVERABLE | B2 | A recoverable error | 
| | { | occurred. | 


x IS NOT A SHARABLE SEGMENT 


A file named in the SEGMENT command as a sharable segment was 
not a valid sharable segment. 
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. APPENDIX C 
LINK TO TET COMPARISON 


This table compares Link to TET, the utility previously used to 
establish and build image load modules under 0S/32. The Link 
commands are listed with the corresponding TET commands as a 
guide to converting from TET to Link. 


TABLE C-1 LINK TO TET COMPARISON 


ae a edie , 
| COMMANDS | COMMANDS | MEANINGS | 
ee eee ener re , 
a ae ee | 
ge ge eg ener eee eee : 
De gg ee eee | 
oo ee | 
te eee ee an | 
Be ge ee Ng og ent deg ne Sonne | 
te Te: eee er npere eee ! 
a ee i acts | 
oe ee ere eae | 
ge eee ee | 
oe a ee ee 
l | | address order | 
) ee ee a 
| | | alphabetical order | 
ae” ae ) | 
Pee i ; | 
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TABLE C-1 


LINK TC TET COMPARISON (Continued) 


ose we ew we BB ew wee www TE eT ee ee ee wT OC eer eee eww ew ww we SE Tew ew ee wesw ew Ow wT we ew eB ww es eww www = 


l LINK 


ene et eee Nh Mel erect ele eee RD reed rere eden necdvnednaadllanadieaardnaditeeatiassdmedpemaliienedivantipundeaedirdibeadsanttanativnrdtieard 
— coe a oe Ge ee ee eee ee a ee a ee ee ee ee ee EN See eee SS eee gee SU ee ee ees a ee ee eee ee ee ee ee ce SO ee ee oe ee oe 


| OPTION 


— oe 


SHARED ** 


| COMMAND 

| parameter 
} in START 
| command 


TET 


Specifies maximum number of task’s | 
logical units | 


MXSPACE 


Sets maximum size of task's system | 
space | 


sets size of absolute memory to | 
precede impure segment | 


Sets maximum number of I/O proceed (| 
requests that can be queued by a | 
task | 


Resolves external references to a | 
Sharable segment | 


‘ | 
is | 
: | 


—_ oo ae ow am oe ce ew eee ee ae oe om ae oe ae oe a ae ee ow oe ae ee ee om ow oe ow oe ae me oe ow ow om oe ow ae ae om arg ow ae am em ew oe ee @ ow ow oe @ @ oe we @ oe 
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* Indicates that the meanings for both Link and TET 
commands are the Samee 


** Link does not recognize previously generated TET 


shared segments. These shared segments must be 
reestablished using Link. 
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APPENDIX D 
TET COMMANDS 


De1 INTRODUCTION 


This chapter describes the OS/32 Task Establisher Task (TET). 
Any task, reentrant library, or preinitialized task common must 
be established using TET before it can run under 0OS/32. The 
functions of TET and the commands used to control it, are fully 
described in this manual. Examples are provided to show how TET 
is used to establish tasks in various environments. The user 
should refer to the 0S/32 Application Level Programmer Reference 
Manual for detailed information about task preparation within an 
OS/32 environment. 


A task may be a single program or a group of programs’ linked 
together. TET processes object code programs, links external 
references, and produces a memory image task for loading and 
running under OS/32. External references to task common and to 
previously established reentrant library segments are also 
processed. 


When a task is established by executing TET, the result is one or 
more load modules of memory image code that can be loaded 
directly into memory using the OS/32 Resident Loader. The 
command stream directing TET activity can be input in batch mode 
or interactively. An operator uses the commands to specify 
programs for inclusion in the task, as well as task options. The 
establishment procedure requires two passes of the object code. 
On the first pass, TET compiles a symbol table of external 
references and definitions.e. On the second pass, the actual load 
module is built. 


TET can also be used to build a memory image of O0S/32 on disc. 
The operating system image produced by TET may be loaded into 
memory by the 32-bit Direct Access Bootstrap Loader, or by the 
Loader Storage Unit (LSJ). 


D.2 SYSTEM REQUIREMENTS 


TET requires 25kb of memory space, plus approximately 2kb for 
dynamic operations, and as much space as is required to house a 
dictionary of all external references and definitions in the 
programs of the task being established. TET may build task 
modules in memory or use a contiguous disc file as work storage. 
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If the task is built in memory, there also must be enough’ space 
to hold the largest load module built. This workspace can be 
allocated at establishment time or load time. In either case, 
the amount of memory for workspace can be approximated as 
follows: 


FUNCTION MEMORY 
For each entry in program 16 bytes 
For each program definition 16 bytes 
For each TET command entered 16 bytes 
If image built in memory 256 bytes and 


largest load module 


Plus 2kb 


To allocate this amount of working Starage at establishment time, 
the TET EXPAND and GET commands are used. Refer to Section D.4.7 
for information. To allocate this amount of working storage at 
task load time, the segment size increment field of the LOAD 
command should be used. For example: 


LOAD TET,TET32.TSK,10 


Required devices include input and output binary devices for the 
input object code and output image code, an ASCII device for TET 
command input, and an ASCII print device for error warning and 
messages to prompt the operator. ASCII device requirements can 
be met by multiple assignments of a CRT or TITY, but high-speed 
devices are recommended for binary input and output. A temporary 
file is a recommended option to hold pass one input programs for 
use during pass two. If a temporary file is not used, the object 
code input file is processed twice. It is also recommended that 
the task be established on disc, because building in mnemory may 
require a very large menory segment. 


De3 AN ESTABLISHED TASK 


An established task consists of at least a main (impure) segment 
made up of one or more object code programs. A task can also 
include a sharable (pure) segment, one or more task common 
Segments, and one or more reentrant library segments. Certain 
run time task conditions can be established by TET. These 
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include limits on the task'’s use of system space, the number of 
logical units (LUs) it may assign, its priority, and its initial 
task status. Most present options can be overridden once a task 
is loaded into memory. Those options that cannot be changed, 
except by reeStablishment of the task, are noted in the command 
descriptions. 


Task address space is divided into one or more program segments, 
sets of contiguous logical program addresses starting on a 64kb 
boundary. All program segments are classified according to their 
contents. That is, they are either pure or impure and task 
common or reentrant library. 

An eStablished task may consist of: 

e cCne main (impure) segment (with optional user overlay) 

e One sharable (pure) segment 

@e One or more task common segments (up to 15) 

@e cCne or more reentrant library segments (up to 15) 

The inclusion of a pure segment, reentrant library segments, oF 
tack common segments is a user option depending on the task to be 
established. A maximum of 16 segments is available for task 


establishment. Table D-1 shows the relationship of the segment 
numbers to the start addresses. 
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TABLE D-~1 ADDRESS-SEGMENT RELATIONSHIP 


ae ee ew we SB CeO ST ST Fe we we ee ee ee we we ee ee 


| 

| STARTING PROGRAM 
SEGMENT | ADDRESS OF THE 

| 

| 


| NUMBER SEGMENT (HEXADECIMAL) 
a a a aaa a da 
| | | 
0 | Y*00000'° | 
| 1 | Y'10000° | 
! 2 | ¥*20000' ! 
| 3 | Y*30000° | 
| 4 : Y "40000! : 
| 5 | ¥*59000' | 
) 6 | Y'60000° : 
| 7 | Y'70000' | 
| 8 : Y*80000' | 
! 9 ! ¥*S0060' | 
| 10 | Y*AOOOO' | 
| 11 ! Y*BOO0O0O' : 
: 12 | Y*C0000' ! 
| 13 : Y'DOOOO' | 
| 14 | Y'EOO0O0' | 
| 15 | Y'FO000' | 


Two types of common are supported under 0S/32: local common and 
task common. Local common is contained entirely within the main 
segment. It is referenced via EXTRNS by the main segment program 
as well as the subroutines of a task (e.ege, FORTRAN common). TET 
allocates space for local common in the task's impure segment as 
defined by the included programs. Task common allows common 
references among 0S/32 tasks and is symbolically referenced the 
same as local common. A particular common block is designated as 
a task common by the TET TCOM command. 


p28 48-005 FOO R01 


Overlays established for a task use a single overlay area. The 
area required by the largest overlay is noted and made part of 
the impure segment. All overlays of a task are loaded at the 
same address in the segment. Overlays of a task may be built 
onto a single file or different overlay files. Overlays may not 
call one another; ieee, nested overlays are not permitted. 


A TET-load module consists of a loader information block (LIB) 
followed bv the memory image of the task in 256-byte records. 
The LIB contains data required by the operating system to load 
the task in preparation for execution. 


De4 TET COMMANDS 


These TET commands can be specified at task establishment time: 


ABSOLUTE MXSPACE 
AMAP NOLOG 
BUILD OPTIONS 
EDIT OVERLAY 
END PAUSE 
ESTABLISH PRICRITY 
EXPAND Q10 

GET REMOTE 
INCLUDE RESOLVE 
JOB REWIND 
LBLCOM TCOM 
LOG TSW 

MAP VOLUME 
MAXLU WFILE 
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| ABSOLUTE | 


De4.1 ABSOLUTE Command 


The ABSOLUTE command is optional. If this command is omitted, a 
256-byte user dedicated location (UDL) area precedes the impure 
task segment. If the ABSOLUTE command is included, it specifies 
an absolute amount of memory which should precede the impure 
segment in place of the UDL. 


Formats: 
ABSOLUTE xxxxx 
Parameter: 


XXXXX is a hexadecimal number of up to five digits 
specifying the number of bytes of absolute- 
addressed code or absolute data to be included 
in the task. 


Functional Details: 


ABSCLUTE establishes a bias of the specified number of bytes 
between address 0 and the start of relocatable code. [In the 
absence of this command, TET automatically reserves 256 bytes 
(X'100') for the UDL. If less than 256 bytes is specified, a 
Warning message is printed, but TET biases the impure segment by 
the specified amount. A task’s UDL may be deleted with an ASS 0O 
commande This command applies to task establishment only. 
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De4.2 AMAP Command 


The AMAP command requests a map with symbols in alphabetical 
order rather than address order. Otherwise, it is identical to 
the MAP command. 


Formats: 
amap [¢a] 
Parameter: 


fd is the file descriptor of the file or device 
that the map is written to. 
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| BUILD | 


De4.3 BUILD Command 


The BUILD command indicates the end of pass one and the beginning 
of pass two. This command causes the load module to be built. 


Formats: 


task [, 


bs [ea] [, [saane] [-seone] || 


cvty [,£a] 


TCOM E [ea] [,sna ne] 


Parameters: 


TASK 


RL 


segno 


indicates a task load module is to be built. 
The output is to the specified fd. If the 
previous ESTABLISH command specified pure, two 
segments are built, one for a pure and one for 
an impure segment. If pure was not specified, 
then only one impure segment is builte If fd 
is not specified, LU 2 is assumed. 


causes one sharable reentrant library segment 
load module to be built, with output to the 
specified fd. RL load modules reguire segment 
NamMeSe The resident loader checks the name 
when the console operator loads a task to see 
if the library segment in memory is the one 
required by the task. All library segments 
should be resident. The RL segment name can 
be specified with the sname parameter, which 
is in this format: filename .ext. If Sname 
is not specified, TET uses the filename.ext 
portion of fd. 


specifies the segment number ta be allocated 
for this library segment. The default is 
segment 15. RL segments must contain only 
pure relocatable code and must not reference 
task common or another RL segment. 
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OVLY causes an overlay module to be output to the 
specified fd. A BUILD OVLY command must be 
entered for, and correspond sequentially to, 
each OVERLAY command entered during pass one. 
Overlays can be built on one file or separate 
files, and are loaded by SVC 5 run time calls 
by the main segment. 


TCOM causes a task common segment to be built and 
output to the file. BUILD TCOM should be used 
when establishing an initialized task common 
segment with a block data program or absolute 
data programe See Section D.4.24. 


sname in the BUILD TCOM command specifies an 
override segment namee If sname is omitted 
when building a block data TCOM, the common 
definition name is selected as the segment 


name. If sname is omitted when building a 
nonblock data TCOM, the segment name is 
derived from the first included file 


containing a program label. 


Functional Details: 


The BUILD command reads the input program file in the same order 
as the first passe If a temporary file is being used, the system 
rewinds it, if possible. Otherwise, the operator is prompted by 
a message to reposition the device. If a temporary file is not 
being used, the operator is prompted to load each program in 
sequencee 


If the file specified by fd or assigned to LU 2 is a contiguous 
disc file, TET builds the load module directly on that file. If 
the file is not a contiguous disc file, TET builds in memory and 
outfruts the load module to the file. If the form of the fd 
parameter is valid for a disc file, but the file does not exist, 
TET allocates and assigns a contiguous file with ae size 
sufficient to hold the task. The output file should not be 
preallocated (or assigned) and TET should allocate and assign the 
output file. 
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ae 


De.4.4 |EDIT Command 

The EDIT command is used to edit a file after inclusion of one or 
more programs. EDIT includes all programs having program labels 
referenced by the already included code. This command can be 


used when a task requires a number of subroutines contained 
Within a subroutine library. 


Format: 
EDIT [fa] 
Parameter: 


fd is the optional file descriptor from which 
additional programs are to be included. If fd 
is not specified, LU 1is assumed. 
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De4.5 END Command 


The required END command terminates TET processing and returns 
control to the operating system» If the operator wishes to stop 
in the middle of an establishment process, and END command must 
"be issued and TET reentered via the operating system START 
command to begin another establishment. Restarting TET is 
necessary to initialize TET pointers and work areas. 


Formats: 


END 
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| ESTABLISH 


De4.6 ESTABLISH Command 


The ESTABLISH command initializes TET task processing. 


Format: 


ESTABLISH 


Parameters: 


TASK 
TCOM 
RL 


PURE 


IMPURE 


NOBDATA 


BDATA 


(/ PURE 
TASK |: 

Vumpure 

|: NOBDATA 
TCCK |. 

|, BDATA 
RL 


indicate whether a task, reentrant library 
Or task common segment, respectively, is to 
he astablished. The defaults for TASK and 
TCOM are IMPURE and BDATA, respectively. 


indicates that any code assembled as pure, via 
the CAL assembler pseudo-op PURE, is 
established in a separate segment. The pure 
segment can then be shared by several copies 
of the same task at tasKx execution. 


specifies that the pure and impure code are 
eStablished in the same impure segment. The 
pure code of such an established task is not 
sharable. If no parameter is specified, 
IMPURE is the default. 


pertains only when establishing ICOM. It 
allows any absolute data (e.ge, DS, DC, or DB 
types of statements), not a block data 
program, to be included as part of the TCOM 
segment. 


specifies that a block data program is to be 


established. If no parameter is specified, 
BDATA is the default. 
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Functional Details: 


If a text editor is established with the code body as pure and 
data areas and bhuffers as impure, Several editing tasks can be 
run simultaneously, each sharing the pure code body of the 
editcor.e The loader checks that the necesSary pure segment is 
already in memory when the task is loaded. The parameter PURE is 
valid only when establishing a task, and is ignored for RL and 
TCOM. 


The ESTABLISH TCOM command is used to separately establish a task 
common segment with initialized data, i.e., block data or 
absolute data. TET does not allow mixing block data with 
absolute data (nonblock data) in a single TCOM segment 
establishment. An initialized TCOM segment can contain either 
block data only or nonblock data only. The distinction is made 
via the BDATA/NOBDATA optional parameter. If a task common 
segment does not contain initialized data, it need not be 
established and need only be declared by the TCOM command when 
eStablisning the task. 


TET allocates contiguous memory for the impure code starting at 
segment 90. If the impure code is greater than 64kb, TET 
allocates the next contiguous segment for the impure task area. 
TET allocates contiguous memory for the pure code, starting at 
the highest available segment, after all library and task common 
segments are resolved. 
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| EXPAND 
GET 


De.4.7 EXPAND and GET Commands 


The EXPAND and GET commands are used to add memory to ae task 
beyond what is required to hold the code body. For example, if 
a task requires an area of memory for processing, such as for a 
symbol table, GET and EXPAND move CTOP upward. They increase the 
minimum memory area in which a task can rune : 


Formats: 


EXPAND xxxx 


Parameters: 


XXXX is a 4&-digit decimal number specifying the 
number of 256-byte blocks to be reserved 
beyond the end of the defined task. 


yyyyy is a hexadecimal number of up to five digits, 
specifying the number of bytes to be reserved. 


Functional Details: 


If neither of these commands is specified, and overlays are 
produced, a default value of X‘'300° bytes is assumed (the amount 
necessary for executing a FORTRAN program). If a task has no 
overlays, the default allocation is 0. 


The GET command can be given with a parameter of 0 to save space 
if no GET STORAGE calls are to be issued. The total number of 
bytes specified by GET and EXPAND is rounded upward to a 256-byte 
boundary. The GET and EXPAND commands can appear anywhere 
between the ESTABLISH and BUILD commands. 
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D.4.8 INCLUDE Command 


The INCLUDE command is required to specify that program(s) from 
a file are to be included into a task (reentrant library or task 
common). 


Format: 
INCLUDE [ea] [-program label | 
Parameters: 


fd is the optional file descriptor of the input 
device. If fd is not specified, LU 1 is 
assumed, in which case the fd should be 
preassigned to LU 1. 


progam label specifies the program name in the input file 
and causes this program to be located and 
included. If a progam label is not specified, 
the entire file is included up to end-of- 
medium or end-of-file. 


Functional Details: 


As the input file is read, TET creates a dictionary of external 
program references. A copy of the included program(s) is written 
to the temporary file, if present. 


48-005 FOO R01 ve 1S 


JOB 


De4.9 JOB Command 


The JOB command allows the operator to title the TET output nap. 


This command is 


Format: 


Parameters: 


title 


permitted any time during the execution of TET. 


is the title given to the TET map. Any 
characters are permitted in this 1- to 
12-character field. All characters beyond the 
twelfth position are ignored. 
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De4.10 LBLCOM Command 


The LBLCOM command can be used to structure a task common sSagneant 
for more than one namei common block. The LBLOOM comnani csausas 
TET to construct references to a task common sagmant for 2ach 
named common that appears in a LBLCOM command ani is rceferancal 
in the task. The LBLCOM commani must be used in conjunction with 
a TCOM command. A TCIM command must be enterei first for evary 
task conmon Segment; one or more LAELCOM commanis nay ba entared 
With the sane segment number. 


Format: 
RW 
LBLCOM nama, /segnd, |/ [/size, | 
RO 
RW 
pNane,/Segnon | / [/sizen | 
RO 
Parameters: 
nana specifies a t- to 8-sharact2ar name OF 3a naineai 
COMMIN « 
segno is the segment number of tha task conn ON. L-£ 


the segno is not the same as tne segnos in tha 
TCOM command for that segment, the LBLCOM 
command is rejectai. Ths maessazg2 ILLESAL 
SEGMENT NO Lis printed. If commani inpat iis 
not remote, TET accapts a LBLCOM conmani with 
the correct segment number. 


RW and &kO specify the access privilegas, read/write and 
real only, respectively. T€ RW ani 20 are 
VkKLtted, tne djlefault is 2d. rhe accass 
otivileges ust be the sama as spartifiei ia 
the TCOM command for that segmearit, Any 
contliet in access privileges causes the 
Warning message ACCESS PRIVILESE CONFLICT to 
be orinted. The access privilag2s ara sat 
emual to those entered with the [T[IO4% command 
for that segment. TET is tren realy to acrtapt 
the next conmand. 
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size is a decimal number specifying the number of 
256-byte blocks. If size is omitted or 
specified as 0, the common block's size is as 
defined within the task. The first task 
definition of the common block determines the 
size. The Size of any subsedquent task 
definition of the same common block must _ be 
less than or equal to the size of the first 
definition; otherwise, a TCOM TOO BIG is 
generated and task establishment is aborted. 
A specified size overrides the actual size as 
encountered in the common definition during 
task establishment. This size must be greater 
than or equal to any common definition for 
that named common in the task; otherwise, a 
TCOM TOO BIG is generated and task 
establishment is aborted. 


Functional Details: 


The name given to the task common segment is the name of the 
first named common block encountered in the task that matches the 
name field in a TCOM or LBLCOM command for that segment. The 
amount of memory associated with a task common segment at task 
load time is the sum of the common block sizes for that segment. 
If a TCOM or LBLCOM command specifies an override size for the 
first named common block that is encountered while building the 
task, the segment size is considered to be an override size by 
the system loader. 
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De4.11 LOG Command 


The LOG command causes all operator commands to be copied to a 
specified output unit. This command is generally used when the 
REMCTE command is usede 


Formats 
Loc [£a| 
Parameter: 


fd specifies the unit to contain the commands. 
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De.4.12 MAP Command 


The MAP command outputs a display of the symbol table that TET 
has built during processing of the programe. If the command is 
entered during pass one, the user may obtain a list of undefined 
symbols to determine which files are yet required. However, MAP 
is most useful at the end of pass two when the establishment is 
complete. The items are output in address order. 


Formats: 


nap [fa] 
Parameter: 


fd is the device on which to display the contents 
of the dictionary. If fd is not specified, LU 
3 is the default. 


Functional Details: 


The following list is a description of each item in a TET map. 
Individual headings are not printed unless there is an item to be 
printed under that heading. Sample maps are included in Appendix 
Ge 


CTOP A hexadecimal value representing the 
last halfword location in the user's 
required memory space. This value 
is always the last halfword ina 
255-byte block, ise@e, XXXXFE~ 


UTGOP A hexadecimal value representing the 
first fullword location above the 
user's established task. It is, in 
effect, the next available location 
in the user's space. 


MIN CORE SIZE A decimal value representing the 
minimum memory size in kilobytes 
required by this segment; Code, 
4.00kb=X°1000° bytes (impure segment 
size in a task plus expand and get 
storage). 
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PROGRAM SEGMENTS 


PROGRAM LABELS 


TASK ENTRY POINTS 


LOCAL COMMON BLOCKS 


UNDEF-SYM FULLWORD 
UNDEF-SYM HALFWORD 


LIBRARY ENTRIES 


TASK COMMON BLOCKS 


OVERLAY 
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All program segments defined Or 
referenced by this task are listed. 
For each segment, the segment name 
and size are listed. During pass 
two, the segment number is also 


listed for each segment. This 
section of the map does not appear 
when establishing reentrant 


libraries or task common segments. 


Entcies in this list are 6-digit 
hexadecimal addresses followad by 
the corresponding 8-character 
program label. Each label 
represents a program label and its 
program address. 


Entries in this list are 6-digit 


hexadecimal addresses and their 
associated symbolic names of all 
symbols processed within the 


established program. 


This section lists the components of 
local common area of the user task. 
An entry is a 6-digit hexadecimal 
address field followed by the local 
common symbol name. 


A list of all fullword external 
references for which no definitions 
have been encountered. 


A list of all halfword external 
references for which no definitions 
have been encountered. 


A list of all resolved references. 
The address fields in this list 
reflect referenced reentrant library 
segments. 


A list of all task common blocks and 
their addressese 


Fach overlay of a task is listed oon 
a separate page after the root has 


been mappede The name of the 
overlay is followed by all entry 
points and undefined symbols 


contained in the overlay. 
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De4.2.13 MAXLU Command 


The optional MAXLU command specifies the maximum number of LUs 
that a task can asSign. 


Format: 
MAXLU lu 
Parameter: 


lu is a decimal number between QO and 254 
specifying the number of LUs. 


Functional Details: 


If this command is omitted, the default value is 15. Note that 
when taking the default or specifying 14 LUs, only 0 through 14 
are available to the task. The command may be entered anywhere 
in pass onee The value of MAXLU determines the size of the 
task's LU table, a dynamic system data structure defined at task 
load time. In memory bound situations, the value of MAXLU should 
be as small as possible to avoid wasting space. Four bytes of 
memcry are required for each LU in the table. 
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De4.14 MXSPACE Command 


The optional MXSPACE command sets a limit on the amount of system 
Space that a run time task can use for dynamic system data 
structures (file control block, etc.) during execution. 


Formats 
MXSPACE xxxxx 


Parameters 


XXXXX is a hexadecimal number of up to five digits 
specifying the number of bytes of system 
space. 


Functional Details: 


A default assumption of 12kb is made if the MXSPACE command is 
omitted. This command can be entered anywhere between ESTABLISH 
and BUILD commands. 
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D.4.15 NOLOG Command 
The NOLOG command halts the LOG command operation. 
Format: 


NOLOG 
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D.4.16 OPTIONS Commani 


The OPTIONS command specifies one or mor: of thea ootions 
associated with a task. 


Format: 


sai = ei : oe ‘3 5 on | 


Parameters: 


UT Normal user task 
ET An executive task (E-task) that can exetute 
privileged instructions. An Petask aust 


tontain only ovoositionally iniepanient code 
(RX¥2 instruction for memsry reference) aad 
cannot reterence reentrant library or task 
common segments. The ET ontion conflicts with 
the PURE andi ROLL options. 


AFPAUSE DF an arithnetic fault octurs ducing task 
execution, the task is to b2 paused. 


AFCONTINUE Tf an arithnetic fault occurs during task 
exertution, the task is to continue. If a task 
is to take arithmetic fault traps, it must be 
established with the AFCONTINUJE option. 


NONRESIDENT At ani-ot-task (EOT), the task is ialeteli from 
memocye 
RESIDENT At EOT, the task ramains in nanory. A 


resident task cannot be a candidate for coll. 


SVCPAUSE Lf an SVC 6 execution is attenpted, tha task 
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SVCCONTINUE 


ROLL 


NOROLL 


COM 


NOCOM 


CON 


NOCON 


UNIVERSAL 


NONUNIVERSAL 
FLOAT 


DELOAT 
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should be paused. This option applies only to 
the background segment. 


If an SVC 6 execution is attempted, the call 
is ignored and task execution continues. This 
option applies only to the background segment. 


The task is a candidate for a roll-out/roll-in 
operation during its execution. If a task of 
higher priority requires the memory occupied 
by this task, it can be written (rolled-out) 


‘to a direct-access device and its execution 


suspended until sufficient memory becomes 
available. The ROLL option conflicts with the 
ET and RES options. 


The task is not a candidate for a roll-out/ 
roll-in operatione 


This task can issue VG 6 intertask 
communication calls (send message, queue 
parameter). 


The task cannot issue Svc 6 intertask 
communication calls (send message, queue 
parameter). 


The task can issue SVC 6 intertask control 
calls (all SVC 6 functions except send 
message, gqueve parameter). 


The task cannot issue SVC 6 intertask control 
calls (all SVC 6 functions except send 
message, queue parameter). 


Specifies that the task has the privilege of 
communicating with all other tasks in the 


system. In a system containing the 
multi-terminal monitor (MTM), intertask 
communication is not permitted between the 
foreground and the terminal environment. 


However, a task that is established (using 
TET) as a universal task can be loaded into 
the foreground and can communicate with the 
terminal environment, using SVC 6 queue 
parameter and send message requests. . 


Communications options are not universally 
allowed. 


Specifies that a task can execute 
Single-precision floating point instructions. 


Specities that a task can execute 
double-precision floating point instructions. 
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NOFLOAT Specifies that a task cannot execute any 
floating point instructions. If the FLOAT, 
DFLOAT, and NOFLOAT parameters are omitted, 
NOFLOAT is the default. 


ACCOUNTING Specifies that the accounting function is 
enabled for a task. 


NACCOUNTING Specifies that the accounting function is 
disabled for a task. 


ACP Specifies that a user task has extended file 
access privileges and can specify an account 
number instead of a file class for all SVC 7 
functions. 


NOACP Specifies that a user task has no extended 
file access privileges. If both access 
privilege parameters are omited, NOACP is the 
default. 

DISC Specifies that a user task has an extended 


disc privilege and can assign to a bare disc 
file. If the disc is on-line, assignments for 
SRO are allowed. All other assignments are 
rejected and a message is displayed. If the 
disc is marked off-line, all access privileges 
are allowed. See the OS/32 Programmer 
Reference Manual for a description of the 
access privileges. 


NODISC Specifies that a user task has no extended 
disc privileges. If both disc privilege 
parameters are omitted, NODISC is the default. 


Functional Details: 


This command is optional, but if entered, it must follow the 
ESTABLISH command and precede the INCLUDE command. The OPTIONS 
command is not valid when establishing a reentrant library or 
task commone The option information is placed in the task LIB, 
and eventually, into the task control block (TCB) at run time. 


Refer to the OS/32 Programmer Reference Manual for a more 
detailed description of each option. If two conflicting options 
are specified in one OPTIONS command, e.ge, OPTIONS ROLL,ET, the 
entire OPTIONS command is rejected. If a successive OPTIONS 
command is in conflict with a preceding OPTIONS command, one of 
the following occurs: 


e The second command takes precedence. This occurs if the 


second command is the direct opposite of the previous command. 
For example: 
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OPT AFP 
OPT AFC 


No error is generated. The arithmetic fault CONTINUE command 
takes precedence. 


e The. second command results in an error. This occurs if the 
second command is inconsistent with the previous command. For 


example: 
OPT RES 
OPT ROLL 


The second command is rejected with an errore The task is not 
rollable. 


The OS/32 operator OPTIONS command may be used to change certain 
of these options. Refer to Chapter 3 for details. 
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De4.17 OVERLAY Command 


The OVERLAY command is used to indicate that an overlay is to be 
included in a task being established. 


Formats: 
OVERLAY name 
Parameter: 


name is the name of the overlay. This name must be 
from one to eight alphanumeric characters, 
with the first character alphabetic. 


Functional Details: 


TET interprets this statement as ending the definition of a main 
segment (or previous overlay), and starting the definition of an 
overlay. Each overlay must be completely defined (with INCLUDE 
and EDIT statements) before another OVERLAY statement is 
presented in the command stream. After all overlays are defined, 
the overlay area is set to the size of the largest area 
requested, starting at the end of the main segment. : 


Only one overlay area is reserved in the task's impure segment, 
no matter how many OVERLAY commands are entered. The OVERLAY 
command must precede the INCLUDE and EDIT commands that define 
its contents, and these must precede any other OVERLAY statement 
or the BUILD command. 
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De.4.218 PAUSE Command 


The PAUSE command temporarily suspends TET operations and returns 
control to the operating system. The operating system CONTINUE 
command is used to return control to TET. 


Format: 


PAUSE 
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De.4.19 PRIORITY Command 
The optional PRIORITY command sets the initial and maximum 


pricrities for the task at run time. This command may be entered 
during pass one, after the ESTABLISH command. 


Format: 
PRIORITY ip,mp 
Parameters: 
ip is a decimal number between 10 and 249 
indicating the initial priority of the task. 
mp is a decimal number between 10 and 249 
indicating the maximum priority of the task. 


Functional Details: 


The number specified as mp must be less than or equal to that 
specified as ip. If mp is not less than or equal to ip, the 
command is rejected. If this command is not specified the 
default value of 128 is assumed for both parameters. 
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De4.20 QI0 Command 


The QIO command allows the user to specify the maximum number 0of 
proceed I/O requests that may be enqueued by a task. 


Format: 

QIo0 n 
Parameters 

n is an integer from ) througia 65,535. 
Functional Details: 


If this command is omitted, the value of n defaults t> O, and 
proceed I/9 requests are processed as in 05/32 RO3-31. Tasks 
established using 8203-092 of TET assume a 0 valua for on. When a 
is set to 0, proceed raquests behave exactly as in Relaase 03-91 
of 0S/32, e.9-, a proceed I/0 request for an LU with an 
Sutstanding request ctaiaus2s tha task tv enter a wait stats unatil 
the first request is conplete, unless unconditional orotead is 
specified, in which case the request is rejectei. The number of 
I/O requests a task may issue before the queue is saturated is 
equal to n plus the number of LU’s with active I/) ongoing. 
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De.4.21 REMOTE Command 
The REMOTE command is used during batch mode (CSS input), to 


instruct TET to abort processing if an error is detected, as no 
operator is present to reposition, rewind, etc. 


Formats 


Functional Details: 


This command can be issued at any point in the sequence, and 
takes effect immediately. Once entered, TET executes to 
completion in this mode. To return to an interactive mode, TET 
must be terminated and restarted. 


In this mode, the use of a temporary file is recommended. Refer 
to Section D.6.-2 tor further information. 
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De4.22 RESOLVE Command 


The RESOLVE command is used to resolve external references to a 
previously established reentrant library segment (such as FORTRAN 
run time library). 


Formats: 
RESOLVE [£4] 
Parameters: 


fd is the optional file descriptor on which the 
reentrant library load module is to be found. 
The default is to LU 1. 


Functional Details: 


This command is used after the program referring to the reentrant 
Library (RL) has been included. The RESOLVE command resolves all 
references to programs found in the reentrant library load 
nodule. The task‘s LIB specifies the reentrant library that is 
required for the task to rune The task aborts during loading if 
its required reentrant library is not present. 
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De4.23 REWIND Command 


The REWIND command assigns a file to LU 1 and rewinds the file. 
Format: 

REWIND [£4] 
Parameter: 


fd is the optional file descriptor of the file to 
be assigned to LU 1 and rewound. If fd is not 
specified, LU 1 is rewound. 


Functional Details: 


The REWIND command is used preceding an EDIT command so that the 
entire file can be edited. In addition, REWIND is used to ready 
a file for pass two, if no temporary file is used. 
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De4.24 TCCM Command 


The TCOM command causes TET to construct references to ae task 
common segment for each named common that appears in a TCOM 


command, and is referenced in the task. 


Format: 
RW 
ICOM name,/segno, j/ [/size,| 


RW 
shame,/segnon |/ [/sizen| 
RO 


Parameters: 


name specifies a 1- to 8-character name of a named 
commone 
segna is the segment number of task common, 


specified as a decimal number from 1 through 


15. This field causes TET 


position the 


task common iin the appropriate area of the 


task's address space. 


RW and RO specify the access privileges 


read only respectively. 


omitted, the default is RW. 


read/write and 
RW and RO are 


size is a decimal number specifying the number of 


256-byte blocks. This size 
actual size as encountered 


overrides the 
in the common 


definition during task establishment. This 


size must be greater than that 
common definition, otherwise 


establish the task. If 


omitted or specified as 0, 


from the common definition. 
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given by the 
TET fails to 


parameter is 


TET takes the size 
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Functional Details: 


Any named common definition in a task is potentially a task 
common. Any named common which does not appear in a TCOM or 
LBLCOM command is considered to he local common, and is included 
in the impure segment. See Section D.4.10 for a description of 
the LBLCOM command. A single TCOM command may describe several 
task commons, or several TCOM commands may be entered, each 
describing one or more task commons. All TCOM commands must be 
entered prior to any INCLUDE commands, and after the ESTABLISH 
command. 


If a TCOM and LBLCOM command specifies an override size for the 
first named common block that is encountered while building the 
task, the task common segment size is considered to be an 
override size by the system loader. If no TCOM command is given, 
but TSKCOM is referenced by the task, TET assumes: 


TCOM TSKCCM/14/RW 


However, if a TCOM command is given, TET does not recognize the 
name TSKCOM unless it appears in a TCOM command. 


NOTE 


The name symbol, generated by the FORTRAN 
V compiler for a common block, consists 
of the user-specified name with a period 
(.) appended. To provide a compatible 
linkage for the CAL user, TET ignores the 
period generated by FORTRAN. 
Specifically, TET removes the period from 
all common block names (both local and 


task common ) that contain one. 
Therefore, the name specified in the TCOM 
command should not contain a final 


period, and a CAL program should not 
contain two common blocks whose names 
differ only by a final period. 
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De4.25 TSW Command 
The TSW command specifies initial setting of the task's run time 
task status word (TSW), and optionally provides a start address 


for the task. The TSW defines trap conditions for which the task 
is responsible. 


Format: 
ToW status |{,start address| 


Parameters: 


status is an 8-digit hexadecimal number indicating 
the setting for the TSW. 


start address is an optional 6-digit hexadecimal number 
indicating the starting address for the task. 


Functional Details: 


If the start address parameter is omitted, the last transfer 
address found in the included code is used as the starting 
address. If no transfer address is found, X‘'100° (the file 
location immediately following the UDL) is assumed. If a 
transfer address is found within the overlay, it is ignored. 


For a detailed description of the TSW see the 0OS/32 Programmer 
Reference Manual. 
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De4.26 VOLUME Command 


The VOLUME command assigns an override of the system default 
volume used by TET during its execution. 


Format: 
VOLUME voln 
Parameters: 


voln is any legitimate volume name of up to four 
characters. Whenever a file descriptor that 
does not specify a volume name is encountered, 
voln is used. 


Functional Details: 


The VOLUME command can be entered more than once, if desired, and 
takes effect immediately. It can appear anywhere in the 
sequence. Refer to Chapter 3 for a description of the operator 
command VOLUME. 
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D.4.27 WEILE Command 
The WFILE command assigns a file descriptor to LU 2 and writes a 
filemark to the file. This command is generally used to separate 


the main segment from the overlays when they are output on 
Magnetic tape or the same contiguous file. 


Format: 
WEILE [£4] 
Parameters 


fd is the file descriptor to be assigned to LU 2. 
If fd is not specified, a filemark is written 
to LU 2, which is left positioned past the 
filemark. 
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D.5 OPERATING PROCEDURES 


TET is run as an established task under OS/32 and is executed by 
use of LOAD and START commands. 


De5-1 Logical Unit Assignments 


Six LUs are used by TET. Table D-2 contains information relating 
to each unit. LUs 1, 2, and 3 can be assigned by TET command 
parameters or by the operating system ASSIGN command prior to 
starting TET. LUs 5 and 7 must be assigned before starting TET. 
If a temporary file is used, it also must be assigned to LU 4 
before starting. A TEMP file can also be used aS a temporary 
file. TEMP files are automatically deleted when they are closed 
at EFOT. 


TABLE D-2 TET LOGICAL UNIT ASSIGNMENTS 


prompts to 
operator 


| | | | | 
| | | | | LOGICAL | 
} LOGICAL { DATA | | DEVICE | RECORD | 
| UNIT i TYPE | USE | EXAMPLES } LENGTH { 
| | | | | 
| SSS SSS LS SS SC SS SL SS SS Se aS Se ae ee Haims some Rss eSSesseSsSSSSace | 
| 1 j Binary | Object-code | Paper tape, | Object 126 | 
| | { input, | Mag tape, | Image 256 | 
| | { Image RL | Disc | | 
| invut | | | 
[SSen SS See See es SSeS See Ss eee aS ee See aa SSeS SSS eS SS Se | 
| 2 | Binary | Image llooad {| Paper tape, ] 256 | 
| j { module | Mag tape, | | 
| | { output | Disc | | 
| ce er eee ewe ee re ewe wee ee me ee wee ee we ee we ee me we te we ee ee we oe we eee ce ee oe ee oe ee we we ee ee es ee oe 
| 3 | ASCII | Memory | Console, | Variable, | 
| | J} map output, | line printer, | up to 120 jf 
| | | Command j VDU | { 
| | | logging { | { 
aeeaies se enrages 9 ORs I ea ae | 
| 4 | Binary | Temporary | Rewindable | 126 | 
| | i file | device, i.e., | | 
| | | (optional) | mag tape, { | 
| | | | disc, etc. | | 
we ee ee ee ete me eee eee ee em eee ees eee ee ee ees eee neem eewwnn 
| 5 | ASCII | Command | Card reader, | 80 | 
| | { input | Console, VDU fj | 
| aan nn rr rn rn ce cece eene oan ne ---- | 
| 7 ASCII Error Console, Variable, 
| messages, line printer, up to 80 
| 
| 
| 


| | | 
| | | 
| warnings, | VDU | 
| | 
| | 
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De-5-2 Temporary File Operation 


The use of a temporary file is a recommended option as it 
minimizes the possibility of errors and allows rapid 
establishment. Because TET uses two passes of the command 
stream, the temporary file contains the programs input during 
pass one for use during pass two. If a temporary file is not 
used and the input file(s) is nat a direct-access file, the 
operator must reload each of the input Files for the BUILD 
process during pass two. If a temporary file is not used, the 
following message iS output to prompt the operator to load 
programs: 


LOAD PROGRAMS fd 


and the program pauses. Programs included from a magnetic tape, 
paper tap2, or cassette must be repositioned. TET should then be 
resumed by the operator command CONTINUE. 


If a temporary file is used, it iS rewound at the beginning of 
pass one. At the end ot pass one, a filemark is written to the 
temporary file and it is rewound for pass twOe Ls a 
nonrewindable device is used, the operator is prompted via a 
message to reposition the temporary file. At EOT, the temporary 
file is rewound, which allows one temporary device to be used for 
successive TET runs without operator intervention. 


NOTE 


If TET is paused during pass two, a 
DISPLAY LU command entered at the system 
console reflects the TET reassignment of 
Luss 


D.5-3 Command Input Sequence 


Certain LU considerations constrain the TET command sequence. 
The commands for establishing a task are input from LU D. If LU 
5 is assigned to an interactive device, TET executes in the 
interactive mode. Otherwise, TET executes in a batch mode. The 
input mode determines the response to error conditions. the 
error messages are summarized in Appendix 4. 


Table D-3 lists the TET commands in recommended order and the 
commands permitted when performing a particular operation. Task 
establishment is begun by the ESTABLISH command with a parameter 
specifying TASK, RL, or TCOM. This command must precede all 
other commands except REMOTE, JOB, LOG, NOLOG, VOLUME, and MAP, 
which can appear at any foint in the stream. The REMOTE command 
prevents TET from pausing in batch mode. This facilitates batch 
processing with minimal operator intervention. 
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Particular operations are: 


TA Ruilding a task 

RL Building a reentrant library 
af i Building a task common 

ov Building an overlay 


All commands are optional except ESTABLISH, INCLUDE, 
END. 
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BUILD, 


and 


VERB 


REMOTE 


JOB 


LOG 
NCLOG 
VOLUME 


ESTABLISH 


QIO 
OPTIONS 
ABSOLUTE 
TCOM 


LBLCOM 


INCLUDE 


OVERLAY 


RESOLVE 
EXPAND 


MXSPACE 


TABLE D-3 LOGICAL TET COMMAND SEQUENCE 


mmr se ee ms were ree we ee ree ee cre we re ee we ee ee ee ee ee ree re er ee re ee ee we ee ee ee ee ee ee 
ee ee ee eee ae ee ee ee ee em ee ee ee ee me ee ee ee ee ee ee ee ee ee ee ee em ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee es ee ee oe 


Anywhere ial * ad * 
Anywhere, ncrmally before MAP and se * * 
AMAP 

Anywhere ~*~ + “A oe 
Anywhere x * * * 
Anywhere x * kok 
Must precede all commands, except 

those which may be specified any- 

where * * * * 


Between ESTABLISH and BUILD 
Between ESTABLISH and first INCLUDE 


Must precede INCLUDE 


Retween the associated TCOM and 
BUILD 


Between ESTABLISH and BUILD or 


between OVERLAY and BUILD ee ee 
Anywhere xt « * 
Must follow at least one INCLUDE — = 
Retween ESTABLISH and BUILD = 

After main segment definition; must 

be followed by INCLUDE or EDIT * * 
After INCLUDE or EDIT * . 


Retween ESTABLISH and BUILD 


Retween ESTABLISH and first 
BUILD/OVERLAY 


* 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
, 
Between ESTABLISH and first INCLUDE | * 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
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TABLE D-3 LOGICAL TET COMMAND SEQUENCE (Continued) 


“a 
tt 
J 
Qu 
oO 
< 


| | | 
| COMMAND | | 
| VERB | SEQUENCE CONSIDERATIONS | TA 
: | | 
| MAXLU } Between ESTABLISH and first - 
| {| BUILD/OVERLAY | 
| | : | | 
} PRIORITY | Between ESTABLISH and BUILD [ = 
| | | 
| TSW | Retween ESTABLISH and BUILD : 
| | 
| BUILD } Must follow all INCLUDE, EDIT and 1 
| } OVERLAY t * 
| | | 
| PAUSE | Anywhere Lo 
| | | 
| WFILE | Anywhere, normally after BUILD 1 
| | | 
| AMAP | Anywhere, normally after BUILD |. * 
| | 
| MAP | Anywhere, normally after BUILD { * 
| | | 
|} END j Anywhere, normally last [= 
NOTES 
1- The BUILD command marks the beginning 
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of pass two for pbuilding the load 
module. This command is input only 
once for each load module. Tasks 
with overlays should contain one 
BUILD command for each corresponding 
overlay. 


The ESTABLISH command marks the 
beginning of pass one. This command 
can be input only once during a TET 
session. 


The OVERLAY command terminates the 
definition of the task's segments 
(impure and pure) during pass one and 
marks the beginning of an overlay 
definition during pass one. This 
command is input once for each 
overlay. 


TET defines the task on the first pass and constructs the task 
load module on the second pass. Therefore, before including any 
task code, TET must know if the task is an E-task or if absolute 
address space is to be reservede As a result, the OPTIONS and 
ABSOLUTE commands must be entered before any INCLUDE commani. 


The distinction between naned common and task common is made by 
the TCOM command. References to named common blocks, iesignated 
as task common by a TCOM command, are relocated to the proper 


program address. The TCOM command must be entered before any 
INCLUDE cemmand. The task*s program contents must then be 
processed. INCLUDE and EDIT commands are used to select the 


input object code programs that are part of the task, task common 
or library. One INCLUDE statement must occur first, to bring in 
a single relocatable program or an entire file. Any number of 
INCLUDE statements may follow. If a single program is included, 
the input read operation stops at the end of that program 
allowing the next inclusion from the same file or another file. 


The EDIT statement reads the entire edit file, and marks for 
inclusion any programs that have program labels referenced by the 
already included code. If a temporary file is present, the 
entire edit file is copied to it, but only the required programs 
are used during the build operation. EDIT statements can be 
repeated, allowing an EDIT to bring in programs referenced in 
code included by a previous EDIT. The user can select programs 
from multiple files by varying the fd parameters of successive 
EDIT and INCLUDE statements. See examples of this in Section 
DeJe 


TET resolves all references from one included program to another 
in a task's included code, but references to a reentrant library 
are unresolved until the input of a RESOLVE command. The RL 
referenced must be previously established. The RL being resolved 
need not be the one currently loaded in the system under which 
TET is cunning. TET reads the LIB of the RL load module, and 
finds the ENTRY symbols that are the same as the referencing 
EXTRNs in the task. A message indicating that the unresolved 
labels exist is output at the beginning of pass two, in addition 
to a table (via the MAP or AMAP commands) which lists these 
symbols. 


Overlays are indicated and named by OVERLAY statements, and 
defined by INCLUDE and EDIT statements, after their main segments 
have been completely defined (by INCLUDE and EDIT statements). 
Space required heyond the area where the task is loaded, for an 
expanding operation such as a symbol table or SVC get storage 
calls, can be reserved with a GET or EXPAND command. GET or 
EXPAND can be entered at any point. The GET or EXPAND area is 
located above the overlay area within the task's memory space. 
After an ESTAS8LISH TA command within TET's first pass, the 
MXSPACE, MAXLU, PRIORITY, and TSW commands can also be entered. 
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The first pass ends and the second pass starts when a BUILD 
command is encountered. Any unresolved references remaining are 
reported by a message to the operator. A 8UILD command creates 
ah image load module for a task, overlay, task common block, or 
reentrant library using the resolutions and specifications of the 
first pass. Each overlay module of a task requires a separate 
BUILD command. The RESOLVE command satisfies all references from 
included programs to previously establishei reentrant library 
segments. A message indicating that unresolved labels exist is 
output at the beginning of pass two. A RESOLVE command may be 
issued for as many library segments as are referenced by the 
included program. 


De6 AUTOMATIC ASSIGNMENT 
Specifying a file descriptor in certain TET commands 


automatically causes the file to be assigned to one of the TET 
LUs. Table D-4 summarizes the action of the specific commands. 


TABLE D-4Y AUTCMATIC ASSIGNMENT OF FILE 


: COMMAND | FD ASSIGNED TO | DEFAULT EXTENSION | 
| | | | 
Nee i ee a cgi acct ll cma | 
| INCLUDE l LU 1 l 93d 
7 EDIT | LU 1 | OBJ ! 
! RESOLVE | LU 1 : RTL | 
| BUILD TASK : LU 2 : TSK | 
| BUILD BL | Lu 2 RTL | 
| BUILD OVLY ) LU 2 OvY | 
| BUILD TCOM | LU 2 | TCM | 
| WFILE LU 2 NONE 
: MAP | LU 3 : NONE : 
| AMAP ! LU 3 | NONE | 
| LOG | LU 3 NONE | 
: REWIND | LU 1 | NONE | 
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Various parts of the fd, or the entire fd, can be omitted by the 
usere Typically, if fd is omitted, TET uses the default LU that 
should be assigned for that function until a reassignment occurs. 
For example, assume the user has asSigned LU 1 to the paper tape 
reader/punch (PTRP:) before starting TET: 


ES TASK 


IN MAG1: 


IN PTRP: 

IN FILEB 

IN FILEA, PROGA 
BU TA, TETOUT 


When T®T finds no file descriptor in the first INCLUDE command, 
it uses the device already assigned to LU 1.2 If no device is 
assigned, THT outputs the message LU 1 NOT ASSIGNED. In this 
case, the paper tape unit is assigned to LU 1, and TET reads data 
from LY 12 The paper tape unit is used for each IN command until 
the IN MAG1: command, where TET closes LU 1 and then assigns the 
mag tape unit to LU 1. Data is read from the mag tape for each 
INCLUDE command (the IN PTRP:), where TET switches LU 1 to the 
paper tape unit again. 


If the user does not specify the volume name, and if the VOLUME 
command has been issued, TET substitutes the volume name 
specified in the VOLUME command. If the VOLUME command has not 
been issued, as in this example, the default system volume is 
used. If the user omits the extension field, TET supplies a 
default extension. The default is selected according to the 
command being executed and the data being processed. Table D-4& 
lists the default extensions. If the fd specified in the BUILD 
command is a disc file, TET allocates a contiguous file of proper 
size to build the load module. If a file with the same name 
already exists, that file is not deleted. 


De? EXAMPLES OF TET OPERATION 

The following examples show the command sequence .used to 
establish tasks under a variety of conditions. In all these 
examples, use of a temporary file is assumed (LU 4 is assigned 
prior to starting TFT). 

DeTe 1 Establishing a Simple Task 


This example illustrates how to establish a simple task. FILEA 
contains the object program(s). 
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ESTABLISH TASK 

INCLUDE FILEA 

BUILD TASK, FILEA.TSK 

MAP Produces a map of the task 
END Returns control to the system 


D.7.2. Establishing a Task with Pure and Impure Segments 


This example illustrates how to establish a task from a file that 
contains programs (segmented in pure and impure form), some of 
which are not required by this task. Programs A, C, and D are to 
be included in the task. Figure D-1 is a description of the 
input and output files. 


| PROGRAM H | | PROGRAM H | 
eee eee | Neeactetateta a | 
| PROGRAM G | 7 | PROGRAM F | 
eae | eceneeevecs | 
| PROGRAM F | | PROGRAM D | 
(ereonres care | leaps erie | 
| PROGRAM E | | PROGRAM C } 
Caen cate | peeterans | 
| PROGRAM D | | PROGRAM A | 
|----------- | CONTAINS EXTERNAL 9 ------=---- 
{| PROGRAM C | REFERENCES TO 

|----------- | PROGRAMS A,D, & H 

{ PROGRAM B | 

| ----------- | CONTAINS EXTERNAL 

{ PROGRAM A | REFERENCES TO 

----------- PROGRAM F 


LOAD MODULE OF 

ESTABLISHED TASK 
RLS ch | (OUTPUT FILE IMAGE 
(INPUT FILE OBJECT CODE) CODE) 


Figure D-1 Establishing a Task with Pure and Impure Segments 


The required command sequence is as follows: 


ESTABLISH TASK, PURE 
INCLUDE FILEA, PROGRAMA 
INCLUDE, PROGRAMC 
INCLUDE, PROGRAMD 
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EDIT Includes PROGRAM F referenced by 
PROGRAM A, and PROGRAM H referenced 
by PROGRAM C. Programs A and D are 
already included. 


BUILD TASK As no fd is specified, and assuning 
that LU 2 is not assigned toa 
contiguous disc file, this task is 
built in memory and output to LU 2. 


MAP Produces a map of the task 


END Returns control to the system 


D.7.-3 Establishing a Reentrant Library 


This example describes the establishment of the FORTRAN run time 
library. The example assumes that the run time library is input 
to TET on five paper tapes. 


ESTABLISH RL Specifies that a reentrant library 
load module be established 


INCLUDE PTRP: Includes five paper tapes 

INCLUDE EPTRP: 

INCLUDE PTRP: 

INCLUDE PTRP: 

INCLUDE PTRP: 

BUILD RL,FORT.RTL,RELIBRY,10 
Builds a reentrant library load 
module with the name RELISRY, using 
seqment 10. 


MAP Produces a map of the completed 
moiule 
END Returns control to the system 


De7-4 Establishing a Complex Task with Overlays 


The task comprises all three programs from File A and, initially, 
one program from File C (Program )D). However, Program D has 
references to Programs A, 8B, and F in the same file. Therefore, 
the main (impure) segment ccntains seven pregrams. Two overlays 
are necessary for the task. The first overlay is from File C 
(Program E with the two references, Programs B and C in File 8). 
The second overlay is File B Program A. Figure D-2 is a gravdhic 
representation of the task. 


D-50 48-0905 FOO RO1 


PROGRAM A 
PROGRAM B 
PROGRAM C 


FILEA 
VOA:FILEA.EX1 


PROGRAMA 
PROGRAM B 
PROGRAM C 
PROGRAM D 


FILE B 
VOB:FILEB.EX1 


PROGRAMA 
INCLUDES LIBRARY 


REFS 
PROGRAM B 
PROGRAM C 


PROGRAM D 
INCLUDES REFS TO 


PROGRAMS A,B,&F 
IN THIS FILE 


PROGRAM E 
INCLUDES REFS TO 
PROGRAMS B&C 
IN FILE B 


PROGRAM F 


FILE C 
VOA:FILEC.EX1 


Figure D-2 
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| 


an 


PROGRAM F FROM FILE C 
PROGRAM B FROM FILE C 
PROGRAM A FROM FILE C 
PROGRAM D FROM FILE C 
PROGRAM C FROM FILE A 
PROGRAM B FROM FILE A 
PROGRAM A FROM FILE A 


DESIRED MAIN SEGMENT 
STRUCTURE 


PROGRAM C FROM FILE B 
PROGRAM B FROM FILE B 


PROGRAM E FROM FILE C 


DESIRED STRUCTURE FOR 
OVERLAY ONE 


PROGRAM A FROM 
FILE B 


DESIRED STRUCTURE FOR 
OVERLAY TWO 


Graphic Description of a Task with Two Overlays 


51 


This command sequence shows the establishment of a task with 
overlays, references to reentrant libraries, and task common 
segments. The main segment and each overlay are built ona 
separate file. Automatic file allocation is used. 


The command sequence to establish the task is as follows: 


REMOTE 
VOLUME VOA 


ESTABLISH TASK ABS 200 


TCOM GLOBAL/13/RW 


TCOM COMALL/12//16 


INCLUDE FILEA.EX1 


INCLUDE FILEC.EX1, 
PROGRAMD 


REWIND FILEC.EX1 


EDIT FILEC.EX1 


RESOLVE MAG1: 
RESOLVE LI82 


MXSPACE 2400 


MAXLU 20 


PRIORITY 20,14 


Specifies that TET should not pause; 
command input is batch. 


VOA is the default volume 
descriptor. 


Provides X‘'200'° bytes of absolute 
address space before beginning the 
impure relocatable code. 


Designated common block named GLOBAL 
as task commons; positions SLOBAL in 
segment 13, program address DQO000. 
Segment has read/write access 
privileges. 


Designates common block named COMALL 
as task common, positions COMALL in 
segment 12, program address C0000. 
Segment has read/write access 
privileges as default override 
segment size=4kb. 


Includes all of FILEA. 


Includes PROGRAM D of FILEC. 


Rewinds FILEC for editing. 


Edits FILEC to include programs A, 
B, and F in the temporary file. 


The RESOLVE command reads the RL 
LIRs and satisfies the raferences. 
The libraries have been previously 
established. 


Allows the task to use up to X‘'24u00'° 
bytes of system space for file 
eontrol biocks. 


Allows the task to use LUS numbered 
between 0 and 20. 


Specifies that the task runs at 
priority 20. The priority may be 
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changed during run time, but may not 
be set higher than 14. 


EXPAND 4 Allows 1024 bytes for get storage 
calls in the main segment. 

OVERLAY OVONE Terminates definition of the main 

: segment: names and initiates 


definition of first overlay. 


INCLUDE FILEC.EX1, First overlay contains PROGRAME from 
PROGRAME FILEC.EX 1/ 
EDIT VOB:FILEB.EX 1 Edits FILEB for programs referenced 


by PROGRAME. Includes PROGRAMB and 
PROGRAMC from FILEB. 


OVERLAY OVTWO Terminates first overlay definition 
and initiates second. 


INCLUDE VOB: FILEB.EX1, Second overlay contains PROGRAMA 


PROGRAMA from VOB: FILE.EX1. 

BUILD TASK,FILED.TSK Initiates pass two processing and 
Starts building the load module of 
the task's main segment, using 


temporary files. The fd of the load 
module is VOA:FILED.TSK.e. The exten- 
sion field can be any three 
characters such as TSK. 


BUILD OVLY,FILFG.OVY Builds first overlay load module 
whose fd is VOA:FILEG.OVY. 

BUILD OVLY,FILEH.OVY Builds second overlay load module 
whose fd is VOA:FILEH.OVY. 

MAP Produces a map of entire task 

END Returns control to the system 


The impure main segment is built with the absolute address area 
first, followed by the main and local common areas, an overlay 
area large enough for the longest overlay, and the EXPAND 
requested area. At run time the system places the CTOP indicator 
at the top of the EXPAND arza, rounded up to a 256-byte boundary. 


The following illustration describes how the task is organized 
when loaded into memory. Note that the two libraries were 
previously established. Segment 15 was allocated for the library 
on MAGi:, and segment 14 was allocated for the library on file 
LIB2~RT Ls 


a ae 


RL SFGMENTS (15) 


(14) 


TCOM SESMENTS (13) 


IMPURE SEGMENT (C0) 


Figure D-3 


FO0000 


E0000 


DO090 


200 


TASK COMMON NAMED *GLOBAL'* 


TASK COMMON NAMED ‘COMALL' 


— oe ee ee ew ww ow ee oe ae ee ow ae oe oe @ oe a ao om ew om ow ae et oF me oe eH ae 


OVERLAY AREA 
LOCAL COMMON 


IMPURE CODE/DATA AREA TASK‘SS 
MAIN 
(ROUT) 
SEGMENT 


USER DEDICATED LOCATIONS 


Memory Mapd of Overlay Task Establishment 


De7-5 Building an Operating System Image 


This command sequence builds 


contiguous file. 


unit. The operating system should be generated in object format 
uSing CUP/MT and the library loader, as outlined in the 05/32 
System Planning and Configuration Guide. TET processes the 
object module produced by the library loader by using the 
following command stream: 
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The 
32-bit direct address bootstrap 


OS 


an 
image 


operating system image on 


loader or the loader 


produced can be loaded by the 
storage 


ESTABLISH TASK 
ABSOLUTE xxxxx 

xxxxx is the address of UBOT from the library loader map. 
INCLUDE MTSYSTEM.OBJ 


Includes the output of the library loader (assumes the object 
is contained on file MTSYSTEM.OBJ). 


BUILD TASK,OS32MT.301 


TET allocates a contiguous file of the proper size and builds 
an OS image. 


END 


Returns control to the system 


NOTE 


To be loadable by either the boot loader 
or the LSU, the fd of the file containing 
the OS image must be of the form: 


OS32xxxx-ehhh 


XxxxXxX Can be any four ASCII characters; 
hhh must be a hexadecimal number between 
X¥'coo' and X‘'FFF*. ; 


D.7.6 Establishing Compound Overlay Files 


The user can build overlays sequentially on a single file. When 
building overlays to single disc files, default allocation of the 
files by TET is not sufficient. The user must allocate the file 
before starting TET. To determine the exact length of the 
required file, lengths of the individual images, expressed as the 
number of 256-byte blocks, must be summed to arrive at the 
approximate total image length. In addition, a single LIB sector 
for each image to be contained in the file, plus four sectors for 
work space, are required by TET. The following numerical example 
is provided: 


Overlay 1 500 hex round up to the nearest X'‘'100° 
byte boundary 

Overlay 2 2200 hex 

Overlay 3 1500 hex 


The segment length expressed in sectors is: 
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a oe 


Overlay 1 500/100 5 sectors 


Overlay 2 2200/1090 = 22 sectors 
Overlay 3 1500/100 = 15 sectors 
TOTAL = 3C sectors (hex) 
+ 3 sectors (LIBs) 
+ 4 sectors (workspace) 
TOTAL = 43 sectors (hex) 


OL 
57 sectors (decimal) 


When generating compound disc files, it is not always permissible 
to change output units during the process. Consider a task with 
four overlays, where overlays 1, 2, and Y are directed to one fd, 
and overlay 3 is directed to another. Overlays 1 and 2 are built 
sequentially. LU 2 assignment is changed for overlay 3, and when 
reassigned for overlay 4, the disc file is rewound. Overlay 4 
overwrites those previously built on that file. It is 
recommended that all overlays for one task be built on the same 
file, or each overlay be built on a separate file. 


De7e-7 Establishing a Block Data Task Common Segment 


The following example illustrates how to establish a block data 
task common segment. Block data is used to initialize the task 
common area. 


ESTABLISH TCOM second parameter defaults to BDATA 
INCLUDE FILEA.FX1,PROGR 

INCLUDE FILEC.FX9 

BUILD TCOM,COMMONBK.TCM 

END 


PROGB in FILEA.EX1 is a block data subprogram containing a common 
block definition named COMMONBK that initializes several items. 
FILEC.EX9 contains several block data subprograms, where each 
program declares common block COMMONBK and initializes Or 
reinitializes items in that block. 


De7.8 Establishing a Sharable Segment 


Assume tile EDIT.OBJ is a text editor whose code body and 
absolute data are assembled as pure and whose buffers and save 
areas (any variable data) are assembled as impure. The following 
command sequence establishes a pure and impure segment ‘for the 
editor task: 
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ESTABLISH TASK,PURE 
INCLUDE EDIT.OBJ 
BUILD TASK,EDIT.TSK 
MAP 

END 


The first time EDIT.TSK is loaded by the operating system loader, 
both the pure and impure segments are loaded intod memory. 
Subsequent loads of EDIT.TSK result in only the impure segment 
being loaded, assuming the pure segment is still in memory. All 
editing tasks share the same pure segment, saving a considerable 
amount of memory. 


D.7.-9 Establishing Preinitialized Task Common 


A load module of a task common can be generated by including 
nonblock data (absolute and variable data) programs as in this 
example: 


a 
a“ 


ESTABLISH TCOM,NOBDATE 


INCLUDE MAG1: Reads all programs on mag tape 

INCLUDE PTRP: Reads all programs on paper tape 

BUILD TCOM,PTRP:,TSKCCM Load module is output on paper tape 
punche Name of task common iis 
TSKCOM. 

MAP CON: Outputs a map on console device 

END 


D.8 TET ERROR MESSAGES 


TETCO1 symbol NOT FOUND 


Search for a pregram label has failed 


TETOO1 ABS LESS THAN 100 


Warning that ABS request overlaps UDL 


TETOO1 ACCESS PRIVILEGE CONFLICT 


Warning that access privileges in a LBLCOM command do not 
match the corresponding access privileges in a TCOM Command. 


TETOO1 ADRS OFLO AT xxxxxx 


Halfword address computation greater than FFFF,. XXXXXx is 
address in program where overflow has occurred. 
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TETOO2 ADRS OFLO AT xxxxxx 


Fullword address computation greater than FFFFrF. XXXXXX 
address in program where overflow has occurred. 


TETOO1 CKSM ERR 


Checksum error on input object file 


TETOO1 DEV END 
End-of-file or end-oft-medium encountered on an LU 
TETOO2 DEV END 


Device unavailable (hardware error) 


ee OOU1 2 OM 


End-of-nedium on LY 1 


TETOO1 EXP TOO BIG 


Expand request makes task greater than X'190009' 


TETOO1 FCB AREA FULL 


Attempt to assign a fiie has failed 


TETCO1 Fo SYNTAX 


File descriptor syntax is incorrect 


TETOO1 FILE ERPS xxxx.-fd 


Error while closing file. xxXxx=SVC 7 status, 
(fd)=filename 


TETCO2 FILE ERR: xxxx fd 


Error while opening file. XXXX=SVC a status, 
(fd)=filename 


TETOO3 FILE ERR: xxxx fd 


is 


lu 


lu 


Error while allocating file. xXxXxx=SVC 7 status, ani lu (fd)= 


filename 
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TETCO1 HW EXTRN ABOVE LIMIT 


Halfword reference corresponding definition ities above 64kb 
address 


TETCO1 ILLEGAL SEGMENT NO. 


Segment number in a LBLCOM command is not used ina previous 
TCOM command. 


TETOO1 ILG ABS ADRS 


ABS code higher than specified in ABSOLUTE command found in 
this task 


TETOO2 ILG ABS ADRS 


ABS code found in reentrant library segment 


TETOO3 ILG ABS ADRS 


ABS code in E-task 


TETOO1 ILG CMD 


Command verb is not valid 


TETOO1 ILG CMD PARM 


Improper command argument 


.TETOO2 ILG CMD PAM 


Tllegal second parameter in a command 


TETOO3 ILG CMD PARM 


Illegal third parameter in a command 


TETOCHY ILG CMD PARM 


Tllegal fourth parameter in a command 


TETOO1 ILS CMD SEQ 


Command not legal at this point in TET operation 
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TETOO1 ILS COMN DEFN 


TET has encountered common loader items while building a 
reentrant library segment 


TETOO2 ILS COMN DEFN 
TET has encountered common loader items while building an 
E-task 

TETOO3 ILG COMN DEFN 


TET has encountered common loader items for block data in 
task common 


TFTQOO4 ILG COMN DEFN 


, 


TET has encountered common loader items for block data in an 
overlay 


TETOO5 ILG COMN DEFN 


TET has encountered common loader items; blank common 
definition found when building BDATA-TCOM 


TETOO6 ILG COMN DEFN 


TET has encountered common loader items: more than one common 
definition in block data subprogran 


TETOO1 [LG DELIMITER x 


Command syntax error; a delimiter other than x is required 


TETOC1 ILG OBJ ITEM xx 


Loader item from an input object program is illegal (xx=iten, 
see Table A4-1) 


TETOO2 ILG OBJ ITEM xx 


Loader item from an input object program is illegal when 
building ETL (xx=item, see Table D-5) 
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TETOO3 ILG OBJ ITEM xx 


Loader item from an input object program is illegal when 
building BDATA-TCOM (xx=item, see Table A4-1) 


TETOO4 ILG OBJ ITEM xx 


Loader item from an input object program is illegal when 
building NOBDATA-TCOM (xx=item, see Table A4-1) 


TETOO1 ILG OPTION 


Roll with F-task, roll with resident 


TETCO1 IMP IN RTL 


Impure code encountered while processing an RTL segment 


TETCOQ4 I/O DEV FRROR xxdd (fd) 


An I/0 error encountered while ‘reading commands; fd=device 
file descriptor or LU 5 not assigned 


TETCO2 I/0 DEV ERROR xxdd (fd) 
An I/0 error encountered while reading input records; 
fd=device file descriptor or LU 5 not assigned 

TETOO3 I/0 DEV ERROR xxdd (fd) 
An I/O error encountered while reading an LIB; fd=device file 
descriptor or Lt! 5 not assigned 

TETOO4 I/O DEV ERROR xxdd (fd) 


An I/0 error encountered while writing to a temporary device; 


fd=device descriptor or LU 5 not assigned 


TETGOS I/0 DEV ERROR xxdd (fa) 


An I/9 error encountered while outputing a load module; 
fd=device descriptor or LU 5 not assigned 


TFTOO6 I/O DEV ERROR xxdd (fd) 


An I/0 error encountered while printing a map; fd=dievice 
descriptor or LU © not assigned 


TETCGO7 I/O DEV FRROR xxdd (fd) 


An I/90 error encountered; SVC 7 fails during preparation for 
pass two; fd=device descriptor or LU 5 not assigned 


TETOO1 LCOM IN OVLY 


Common definition in overlay segment is not previously 
defined in main segment 


TETOO1 LCOM TOO BIG 


Labeled common too large 


TETOO2 LCOM TOO BIG 


Blank common too large in overlay 


TETCC1 LCOM IN RTL 


Encountered common loader item while building reentrant LIB 
segment 


TETOO1 LOAD PROGRAMS £d 


Frompts operator to load program if temporary device is not 
being used, or to rewind invut fd 


TETOO1 LU (lu) NOT ASSIGNED 


No device assigned to this LU 


TETOO1 MEM FULL 

TET work area has been exhausted. No room to build first LIB 
TETOC2 MEM FULL 

TET work area has been exhausted. No room to build 


subsequent LIBs 


TETOO1 MULT DEFD symbol 


Multiple definition of the same symbol 
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TETOO1 -NO DCHN END xxxxxx 


Xxxxxxx is the def address. Address dechaining 
200,000 links 


TETOO1 NO ENTRIES IN RTL 


No entry definition found when building RTL 


TETOO1 OUTSIDE AVAIL MEM 


Internal TET errore. Attempt to store image 
available user space 


TETOGC2 OUTSIDE AVAIL MEM 


Internal TET error. Attempt to store image code 
space 


TETOO1 OV NAME MULT DEFD 


More than one overlay with same name 


TETOO1 OV MULT DFEFD symbol 


Two Or more overlays define a symbol referenced 
segment 


TETCO1 TCOM ACCESS PRIV ERR xxxx 


Access privilege in TCOM command not RQ or R 
common name) 


TETOG1 PROG TOO BIG 


Task greater than X‘'100000' 


TETCO2 PROG TOO BIG 


KL greater than 64kb 


TETOO3 PROG TOO BIG 


TCOM size greater than X‘'100000° 
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fee 
4 


has exceeded 


code above 


below user 


by the main 


W (xxxx=task 


TETOO1 REPOSITION SCRATCH 


Message to operator when using nonrewindable temporary device 


TETOC1 RESOLVE ERR 


Input file not an RL file 


TETCO2 RESOLVE ERR 


Input file not the same name as ina previous RESOLVE command 


TETOO1 SEGMENT ADDRESSING ERROR 


Error while mapping logical segment into task address 
segment start address plus size greater than Y'100000° 


TETOO2 SEGMENT ADDRESSING ERROR 


Error while mapping logical segment into task address 
segment addresses overlap 


TETGO3 SEGMENT ADDRESSING ERROR 


Error while mavoping logical segment into task address 
not enough contiguous space tor a segment 


LETOC1 SEQ ERP 


Sequence number error on input object file 


TETGO1 SHORT RECOPD 


Record length of build file is less than 256 


TETOO2 SHORT KECOED 


Kecord length of temporary file is less than 126 


TETCQ1 TCOM ADRS OUT OF RANGE xxxx 


Segment number in TCOM command is less than 1 or great 


15-6 (xxxx=task common name) 


Space; 


Space, 
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TETCO1 TCOM MULT DEFD xxxx 


Name xxxx in TCOM command has been used previously in TcCOM 
command 


TETOO01 TCOM NAME SYNTAX ERROR xxxxx 


Name xxxx in TCOM command longer than eight characters or not 
terminated by /. 


TEEOO), “TCO -TOO- BPG 


Second task common definition larger than first 


TETCC2 TCOM TOO BIG 
Override size in fTCOM command smaller than in common 
definition 

TETOO1 TET 32 ABORTED 
An unrecoverable condition has been detected in batch mode; 
operator action is required 

TETOQOO2 TET 32 ABORTED 


An unrecoverable condition has been detected when building; 
no impure or pure code 


TETGCO3 TET 32 ABORTED 


An unrecoverable condition has been detected; pass two 
command not found in dictionary 


TETOGG TET 32 ABORTED 
An unrecoverable condition has been detected, alit table 
overflow: more than 6192 programs processed by EDIT 

TETOO5 TET 32 ABORTED 


An unrecoverable condition has been detected, common 
reference; no corresponding definition 
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TETOO6 TET 32 ABORTED 


An unrecoverable condition has been detected, block data; no 
corresponding definition 


TETOQ7 TET 32 ABORTED 


An unrecoverable condition has been detected, overlays 
included not found in dictionary 


TETOOS -TET 32 ABORTED 


An unrecoverable condition has been detected, builiing 
overlay; overlay not found in dictionary 


TELCOS. “TERT 32 ABORTED 


An unrecoverable condition has been detected, object record 
read routine failed 


TETO19 TET 32 ABORTED 


An unrecoverable condition has been detected; segment table 
validation error 


TETrei. Ter 32 ABORTED 


An unrecoverable condition has been detected; invalid command 
in error ftormat table 


TEPOT2> TET 32 (PBOrTeED 


An unrecoverable condition has been detected; a common block 
defined in a TCOM command contains block datae 


TETOO1 TOO MANY SEGMENTS 


More than 16 program segments 
TETOO1 TOO MANY TCOMS xxxx 


Only 15 task commons can be named in TCOM commands (xxxx=task 
common name) 


‘TETOCT UNDEFINED SYMBOLS 


Qperator warning that undefined symbols exist 
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TETOO1 WRONG PROG 
Program encountered on pass two is in 
in dictionary 

TETOO2 WRONG PROG 


Program encountered on pass two is in 
wrong address ; 


TETOO3 WRONG PROG 


Frogram encountered on pass two is in 
symbol in common DEF‘s ; 


TETOO4Y WRONG PROG 


Program encountered on pass two is in 
Subprogram not included when building 


TETOQS WRONG PROG 


Program encountered on pass two 


wrong order; symbol not 


wrong order; symbol has 


wrong order; no such 


wrong order; block data 
BDATA-TCOM 


is in wrong order; 


relocatable address in fass two beyond limit 


TETOO6 WRONG PROG 


Fregram encountered on pass two is in 


size not same as pass one size 
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wrong order; module 


el 


TABLE D-5 OBJECT ITEM SIGNIFICANCE 


ITEMxx 


co) 
to 
Cy 
tr} 
Q 
= 


er mm me ee ee ee wee ee ee re ete cree cere ee me ee ee er ee ee ee ee ee we ee ee ee ee ee ee ee ee ee 
=—S Se SS Sm OO we ee ee we ee ee ee eee ee em ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee eee ee ee oe 


End-of-recorid 

End-of-program 

Reset seguence number 

Block data indicator 

Absolute program address 

Pure relocatable program address 
Impure relocatable program address 
Two bytes of pure relocatable data 
Two bytes of impure relocatable data 
Four bytes of pure relocatable data 
Four bytes of impure relocatable data 
Common reference 

EXTRN 

ENTRY 

Common definition 


Program label 


Three bytes ABS and three bytes pure relocatable 


data 


Three bytes ABS and three bytes impure relocatable 


data 


Load program transfer address 


cee cee ere 2G cme cme ae one ee (eee ee oe nee Cee SEEN ey, SEU UE ee Ge ee ee ee ee eee SE eee Se ame eee ou comm me cue Stee coe 
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TABLE D-5 OBJECT ITEM SIGNIFICANCE (Continued) 


we ewe ere eee we ee ee ee ew oe ae a oe om om om ee SF oF ae om om or cm ce om oo ae om om a i of om om oe ew oc oe apo oo ue aw = wo oe ae ee ew ow oe 


vee et eee meee res mee mm ce me rs er re ee cee mee ee ee es ee cr cee cee cee ec we ee ee ee ee ee ee oe 


| | 

| OBJECT | 

| ITEMxx | MEANING 

| eo Sessa tes seas Sse se Sree s sss ees sees SSS ses SS SSeS SSeS SSeS Ssa 
| Bie | Define start of chain 

| | 

} 14 | Load chain definition address 

| | 

, 15 | Two bytes ABS and two bytes pure relocatable data 
| | 

| 16 | Two bytes ABS and two bytes impure relocatable data 
| | 

| 17 | Short form EXTRN 

| 

| 18 | Length of impure and pure segments 

| | 

} 19 } Perform fullword chain 

| 

|} 1A |} Perform halfword chain 

| | 

| 1B | No operation 

| | 

fF AC | 2-byte pure translation table address 
| 

| 1D | ?-byte impure translation table address 
| | 

i SE | Illegal 

| | 

} 1F } One byte ABS data 

| | 

{ 2¢ | Two bytes ABS data 

| | 

{ 21 { Four bytes ABS data 

| | 

[aed | Six bytes ABS data 

| | 

| 23 {| Eight bytes ABS data 

| e | e e e e 

| e | e e e e 

| bd | e e e e 

| 52 { 120 bytes ABS data 

| | 

J 5C | 

I, “tO | Tllegal 

b oes | 
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Absolute 


Absolute data 
Access privilege, 


Accounting 
Active LINK commands 


Arithmetic fault pause 


B 


Backspace file (BFILE) command 


BUILD command 
allocation 
assignment 
contiguous file 
‘jndexed file 
maps 


Building image load modules, 


COBOL task 

COBOL task, commands 
imbedded 

FORTRAN task 
operating system 


overlaid task, complex 


overlaid task, simple 

referencing sharable 
segments 

simple task 


Building sharable Segments 


G 
COMMON 
Common blocks 
external 
local 
moving 
D 


Define command (DCMD) : 
imbedded commands 
pseudo-op 

DNTRY 
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a7 22 
ao13 
3-13 
3-13 
4-8 


INDEX 


erent ti i re i Ee ee et 


E 


END command 

End of task codes 

ENTRY 

Entry point symbol 
Environment LINK commands 


ESTABLISH command 
Executive task 
Extended disc privilege 
Extended file access 
privilege 
Extended options fullword 
EXTERNAL command 

common blocks 


F GH 


File descriptors 


Floating point instructions, 


double precision 
single precision 


Forward file (FFILF) command 


I J 
Image I/0 
Image load modules, 
building 


operating system 
Sharable segment 
task 
IMPURE 
INCLUDE command 
object modules 
Intercept 
Intertask communication 
Intertask control 
I/O control blocks 


K 


Keycheck 


L 


LIBRARY command 
entry points 
external references 
EXTRN pseudo-op 
non-linking external 
references 
object libraries 
weak entry points 


weak external references 


(eto 
on 


WWW Ww ww ww Ww 
It 
ND |] Wh 32 wh Ow 


aon yo 


Ind-1 


LINK, 
building 
commands 
command summary 
command syntax 
comparison to TET 
features 
file descriptors 
loading 
message summary 
requirements 
starting 

Loading LINK, 


from MTM terminal 
from system console 


LOCAL command 
entry point 
Sharable segment 
LOG command 
command input 
maps 
messages 
Logical units 


MAP command 
address 
ADDRESS 
ALPHABETIC 
build summary 
XREF 

Map listings 


NDCMD command 
No log (NLOG) command 


0 


Operating system image load 
module 
OPTION command 
ABSOLUTE 
ACCOUNTING 
ACP 
AFPAUSE 
COM 
CON 
DFLOAT 
DISC 
ENTRY 
ETASK 
FLOAT 
INTERCEPT 
IOBLOCKS 
KEYCHECK 
LU 
NACCOUNTING 
NACP 
NAFPAUSE 
NCOM 
NCON 
NDFLOAT 
NDISC 
NFLOAT 


Ind-2 


aoe. 


Na WN AA OA Fwd 
1 
aN 2a Fe ow a = a= 


3-10 
3-26 
3-29 
3=31 
3-28 
ga27 
3°27 
a2 
3-28 
3-28 
3-30 
3-27 
3-28 
3-31 
3-29 
3-31 
3-29 
3-31 
3-28 
3-27 
3-27 
s=27 
3-29 
3-28 
3-28 


NINTERCEPT 
NKEYCHECK 
NRESIDENT 
NROLL 
NSEGMENTED 
NSVCPAUSE 
NUNIVERSAL 
NVFC 
NXSVC1 
PRIORITY 


RESIDENT 
ROLL 


SEGMENTED 
SVCPAUSE 
SYSSPACE 
TEQSAVE 
TSW 
UTASK 
VFC 
WORK 
XSVC1 
Overlay command 
level 
overlaid tasks 
overlay name 
root segment 
Overlay structure 


PQ 


Passive LINK commands 


PAUSE command 

POSITION command 
common blocks 
root segment 

Priority of task, 
initial 
maximum 

PROG 

PURE 


RESIDENT 
REWIND command 
ROLL 


SEGMENTED 
Sharable segment 


access privilege 
building 


SIZE 
starting address 


task common block 


3-27 
1-1 

3-10 
3-10 
4-9 

4-10 
3-38 
3-11 
3-38 


Sharable segmented image load 


module 

SHARED command 
access privilege 
sharable segment 
task common block 


3-10 
3237 
3=37 
3-37 
2738 
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Shared-read-only assignments 3-28 | TITLE command 3-40 
Starting LINK 2-3 | TSW 3-30 
Statement syntax conventions 1-2 | 

System space 3-29 u 

T | UNIVERSAL 3-28 
User task 3-27 

Task image load module 3-10 | 

Task status word, | V 
address portion 3-30 : 
status portion 3-30 | Vertical forms control (VFC) 

TET, option 3-31 
automatic assignment D-47 | VOLUME command 3-41 
commands D-5 | 
error messages D-57 | 
established task D-2 WX Y Z 
examples of operation D-48 
operating assignments D-41 | WFILE command 3-42 
system requirements D-1 | Workspace 3-29 
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